身份实名认证API开发文档

小太阳

服务主要功能描述

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

1) 通过https协议post方法上传图像文件，通过https接口进行识别；

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

4、服务调用约束

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

接口说明

接口地址：

接口调用方法：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	类型错误