身份实名认证API开发文档

服务主要功能描述

身份实名认证API(翔云),实时联网权威数据源,核验上传的姓名+身份证号(可以上传身份证图片系统自动识别)+上传的人脸图像与数据源内的身份证头像相似度,并返回人像比对相似度百分比值。

  1. 通过https协议post方法上传图像文件,通过https接口进行识别;

  2. 将核验结果以XML或json格式返回给用户;

4、服务调用约束

在调用身份实名认证标准版接口前,请您确保客户端程序或设备网络连接通畅,要求上传人像图片小于100kb。

接口说明

接口地址:https://netocr.com/verapi/veridenOrd.do

接口调用方法:post

3、请求参数

名称 类型 必填 说明

key String 是 用户ocrKey

secret String 是 用户ocrSecrert

trueName String 是 姓名

idenNo String 是 身份证号

img String 是 场景照片(JPG格式照片的Base64编码,编码后大小不能超过1M)

typeId Integer 是 身份实名认证标准版:3013

format String 是 返回格式(xml或者json),如果format为空,则默认返回xml

接口返回值参数说明

序号 名称 类型 说明

1 verify_result_status String 身份信息核验结果1:判定为同一人2:判定为不同人3:不确定是否为同一人4:姓名与身份号码不匹配5:库中无照片6:库中无此号7:图片不合格

2 verify_similarity String 比对值0 < verify_similarity < 40:判定为不同人40 ≤ verify_similarity ≤ 44:不确定是否为同一人45 ≤ verify_similarity:判定为同一人

状态码说明:

status code message

0 调用成功(扣费)

400 参数缺失

410 参数无法解析

420 传入参数错误

999 服务器错误

调用错误码

status值 描述

-1 用户已屏蔽

-2 用户key或secret验证错误

-3 服务次数不足

-4 用户未找到

-6 系统异常

-7 图片不可为空,参数不可为空

-8 类型错误

调用方式(java客户端基于httpclient4.3)
1.依赖库: \java客户端\httpClient4.3库\,如图:

2.示例程序代码详见: \java客户端\httpClientDemo\中的Client类,如图:

在main方法定义参数,并传入 doPost(url, file, key, secret, typeId, format) 方法中。如图:

返回结果如下:

<?xml version='1.0' encoding='UTF-8'?>
<status>0</status>

<value>处理成功</value>
<Info>

  <veritem desc="verify_result_status">2</veritem>

  <veritem desc="verify_result_desc">判定为不同人</veritem>

  <veritem desc="verify_similarity">9</veritem>

</Info>

{

“messageString”:{“status”:“0”,“value”:“处理成功”},

“infoList”:[

{

“veritem”:[

{“desc”:“verify_result_status”,“name”:null,“content”:“1”},

{“desc”:“verify_result_desc”,“name”:null,“content”:“判定为同一人”},

{“desc”:“verify_similarity”,“name”:null,“content”:“93”}

]

}

]

}

上一篇:layui表单验证增加自定义校验方法


下一篇:32. Django 2.1.7 模板 - 图片验证码的实现