身份验证(公安简项)
接口描述
用户通过发送HTTP Post请求方式提交数据至公有云服务器,服务器识别并返回json格式的识别结果。
接口说明
请求URL:http://api.exocr.com/data/v1/verify_id
请求方式:HTTP Post
返回格式:json
Header
参数 | 值 |
---|---|
Content-Type | 使用二进制方式时,为multipart/form-data;使用url方式时,为application/x-www-form-urlencoded |
请求参数
参数 | 必选 | 类型 | 说明 |
---|---|---|---|
app_key | 是 | string | 请在控制台->我的应用中获取 |
app_secret | 是 | string | 请在控制台->我的应用中获取 |
personal_name | 是 | string | 姓名 |
identity_card_no | 是 | string | 身份证号码 |
调用示例
java(相关依赖库下载)
package com.exocr.httpclient;
import java.io.FileNotFoundException;
import java.util.HashMap;
import java.util.Map;
import com.exocr.common.utils.HttpClientUtils;
public class Test {
public static void main(String[] args) throws FileNotFoundException {
//识别url
String url = " http://api.exocr.com/data/v1/verify_id";
//设置请求参数
Map<String, String> params = new HashMap<String, String>();
params.put("app_key", "#####");
params.put("app_secret", "#####");
params.put("personal_name", "张三");
params.put("identity_card_no", "##########");
//发送请求,得到识别结果
String string = HttpClientUtils.doPost(url, params);
System.out.println(string);
}
}
返回示例
{
"result": {
"gender": "0",
"birthday": "1992-11-03",
"desc": "比对通过",
"result_code": 10000
},
"error_code": 0,
"description": "调用成功",
"request_id": "57A1D56249FB4E01B8A9EE7D4B6287DD",
"recognize_time": 98,
"available_count": 79
}
返回说明
通用参数
参数 | 类型 | 说明 |
---|---|---|
result | array | 返回结果数组,包括所有识别信息 |
error_code | int | 错误码,返回0为正确,其他为错误 |
description | string | 识别结果描述 |
request_id | string | 请求唯一标识符 |
recognize_time | int | 识别所用时间,单位为毫秒 |
available_count | int | 识别剩余可用次数,次数不足时无法继续识别,可在控制台进行充值次数 |
result特有参数
参数 | 类型 | 说明 |
---|---|---|
gender | string | 性别 |
birthdate | string | 生日 |
desc | string | 认证结果描述 |
result_code | int | 认证结果码 |
认证结果码
结果码 | 类型 | 说明 |
---|---|---|
10000 | int | 比对通过 |
10001 | int | 比对不通过,身份证号码正确,但与姓名不一致 |