人像三要素核验接口文档

---

1.接口说明

名称	说明
协议	HTTPS POST
地址	https://api.cxlnk.com/api/identityVerify/faceThree
Accept	application/json
Content-Type	application/json;charset=utf-8

2.请求参数说明

响应 body 数据为 JSON 格式

列表	内容	备注
accessKey	API调用账号（必填，String类型，从灿星云平台获取）
accessSecret	API调用密钥（必填，String类型，从灿星云平台获取）
idNo	身份证号码（必填）
name	姓名（必填）
image	人脸照，base64字符串（必填），base64字符串去掉头部描述(如data:image/png;base64)	注：当您在进⾏实人认证的时候，请传入满足以下所有条件的图片： 认证主体的近期照片，人脸需要完整清晰无遮挡、表情自然且正对摄像头。 照片清晰、曝光正常，脸部无过黑、过亮、光晕等情况、角度无太大偏差。 分辨率不超过1920*1080（高*宽），至少640*480，推荐短边缩放到720像素，压缩率大于0.9。照片高大于宽，如果传入的照片宽大于高，可能会影响检测效果。 支持照片格式为jpg、jpeg、png，照片大小需小于1MB

3.请求参数示例

{
 "accessKey": "NDYw*******",
 "accessSecret": "MDQyOTQ1OTM3*********************",
 "idNo":"341225****",
 "name":"李明",
 "image":"DAQL/xAA+EAACAgEEAAUCAwYD***************"
}
					

4.响应参数列表

列表	内容
code	状态码200则为成功
msg	状态说明
success	处理是否成功:取值范围 true，false
data	业务数据 如果失败则为空
result	结果描述
code	说明： -1：接口异常或超时 -2：参数错误 -3：无效的外部订单号 -4：无效图像尺寸、大小 -5：图像解析失败 -6：内部错误，请联系供应商 1：认证通过 2：人像比对非同一人 3：人像疑似 4：上传图片大小、格式、质量不合格或不可用 5：身份信息无效 6：数据库中无该人信息 9：其他错误
fee	是否扣费0不收费1收费
reqNo	请求唯一标识
photoScore	比对分 photoScore大于或等于60确认为同一人；40小于或等于photoScore小于60不确定为同一人；photoScore小于40确定为不同人

5.响应参数示例

{
 "code": 200,
 "msg": "认证通过",
 "success": true,
 "data": { 
          "result": "OK",
		  "code": 1,
		  "fee": 1,
		  "reqNo": "37fc53a6238c4806845943f726***",
		  "photoScore": "99.95"
    }
}
						

6.Result返回说明

Result返回说明	描述
OK	认证通过
NOT_SAME_PERSON	身份信息无效
NOT_EXIST_ERROR	接口异常或超时
INVALID_PARAM	参数错误
INITIALIZE_INVALID_OUTORDERNO	无效的外部订单号
ILLEGAL_IMAGE_SIZE	无效图像尺寸、大小
FETCH_IMAGE_FAIL	图像解析失败

7.结果码说明

结果码	描述
200	成功
500，501，503	系统错误
502	系统繁忙
60021	余额不足，请充值后重试！
10000	内部系统出错，请联系厂商