1 接口定义：
平台仅支持以POST提交数据，请求参数个数固定，如下表所述：
| 接口名称 | 公安三要素 |
|---|---|
| 接口描述 | 判断姓名、身份证号码、人脸图像是否一致 |
| 承载协议 | HTTPS |
| 承载网络 | 公网 |
| 请求方式 | POST |
| 数据格式 | 返回数据：json格式 |
| 请求ContentType | application/x-www-form-urlencoded |
| 接口URL | https://api-s.21cn.com:9083/id/idcardFaceCompare.action |
【请求参数】
| 字段标识 | 说明 | 数据类型 | 可空 |
|---|---|---|---|
| appKey | 授权访问的appKey | text | N |
| accessToken | 通过appKey和appSecret获取的accessToken， 参考获取accessToken | text | N |
| faceString | 图片的base64编码，小于等于5MB，格式为 JPG（JPEG），BMP，PNG，GIF，TIFF，宽和高大于 128px，小于等于4000px | text | N |
| idNumber | 身份证号码 | text | N |
| userName | 持证人姓名 | text | N |
| requestId | 请求流水号，用于跟踪问题 | text | N |
【响应参数】
| 字段标识 | 说明 | 数据类型 | 字段含义 | 可空 |
|---|---|---|---|---|
| errorCode | 1 调用成功 其余调用失败 11004 图片过大 13051 输入的姓名或身份证号码有误 | number | 结果码 | N |
| errorMsg | string | 结果描述 | N | |
| result | 详见《result对象》 | string | 结果对象 | N |
【result对象】
| 字段标识 | 说明 | 数据类型 | 字段含义 | 可空 |
|---|---|---|---|---|
| resultCode | 13050 库内照片质量不佳 13051 输入的姓名或身份证号码有误 13052 库中无此号 13053 库中无照片 13054 上传相片质量校验不合格 13055 特征提取失败 13056 检测到多于一张人脸 13057 照片base64编码异常 13058 身份证号与姓名不匹配 13059 系统判断为不同人 13060 系统判断为同一人 13061 系统判断为疑似同一人 13099 调用比对引擎接口出错 | string | 结果码 | N |
| resultMsg | string | 结果描述 | N | |
| score | string | Y |
【返回示例】
{
"errorCode": 1,
"errorMsg": "成功",
"result": {
"resultCode": 13059,
"resultMsg": "系统判断为不同人"
}
}