出入境两项及人像+出入境证件

接口功能 根据证件类型+国籍+姓名+证号+人像，核验个人身份
接口地址 /ids/v1/identities/modeTwoAndPhotoEntryAndExit
请求类型 POST

1. 业务请求参数说明

字段名称 字段描述 类型 是否必须
transId 业务ID，传递15-64位的随机数（建议业务系统进行日志记录，方便根据id排查问题） String 是
appId 接口调用方（业务系统）的ID标识 String 是
idNumber 证件号码 （证件号码长度不能大于16） String 是
name 姓名 （姓名长度不能大于66） String 是
idType 证件类型 （证件类型长度不能大于35位）· OVERSEAS_CHINESE_PASSPORT 华侨护照· HOME_RETURN_PERMIT 港澳居民来往内地通行证· ALIEN_PERMANENT_RESIDENCE_ID_CARD 外国人永久居留身份证· TAIWAN_RETURN_PERMIT 台湾居民来往大陆通行证 String 是
nation 国籍· 国籍长度不能大于三位· 华侨 和 港 澳 人员 使用 CHN String 是
photoData 照片base64· 去除头部“data:image/jpeg;base64,”· 最大40k,建议大于5k· 格式jpeg String 是
appointChn 业务端制定渠道，具体渠道值参照渠道获取接口（目前只有此一个渠道）· yisuo String 否

2. 请求报文示例

{
    "transId": "qwdswfgewfe12312fwfwe",
    "appId": "ceshi",
    "idNumber": "342601196708094316",
    "name": "张三",
    "idType": "516",
    "nation": "CHN",
    "photoData": "iVBORw0KGgoAAAANSUhEUgAAAIs……"
}

3. 业务响应参数说明

字段名称 字段描述 类型 是否必须
transId 方法调用时传入的transId，作为结果原样返回 String 是
identityResult 校验结果 String 否
identityResultDesc 校验结果描述 String 否
faceResult 人像比对结果 String 否
faceResultDesc 人像比对结果描述 String 否
score 人像比对分值 String 否

4. 成功响应报文示例

{
     "status": 200,
    "success": true,
    "message": "SUCCESS",
    "data": {
        "transId": "qwdswfgewfe12312fwfwe",
        "identityResult": "SUCCESS",
        "identityResultDesc": "文本信息对比一致",
        "faceResult": "SUCCESS",
        "faceResultDesc" : "同一人 (人像加密)"
     }
}

5. 失败响应报文示例

{
    "status": 22013008,
    "success": false,
    "message": "身份核实认证失败,参数错误(Photo非base64)"
}

6. 错误码说明

6.1 status-message

错误码 错误描述
22004001 请求参数错误
22004002 操作数据库异常
22004008 请求超时
22013007 身份核实申请失败
22013008 身份核实认证失败
22013009 人像比对失败
22013005 DSVS加密失败
22013006 DSVS签名失败
22030000 未知的渠道策略
22030010 渠道策略表达式非法

6.2 identityResult-identityResultDesc

错误码 错误描述
E_001 参数错误
E_007 文本信息对比不一致
E_008 文本信息对比一致但证件失效
H_000 无户籍（如华侨人员）
H_00X 未确定或不确定有无户籍
S_017 信息未执行

6.3 faceResult-faceResultDesc

错误码 错误描述 可能原因
F_001 对比不是同一人 1、 照片为本人，但是照片可能有角度、光线过暗、脸部区域有亮斑 2、 照片为本人，但是该照片尺寸太小3、 两人长相类似
F_00D 人像数据未录入 数据库中无该人像模板
F_00E 现场照片质量不足或格式不对 1、 照片可能有角度、光线过暗、脸部区域有亮斑、模糊 2、照片尺寸太小 3、非 JPEG 格式的图像
F_00H 活体检测控件版本过期或检测数据校验失败 1、活体检测控件版本过期 2、活体检测数据校验失败
S_017 信息未执行