出入境两项实名+出入境证件

接口功能 根据证件类型+国籍+姓名+证号核验个人身份
接口地址 /ids/v1/identities/modeTwoEntryAndExit
请求类型 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 是
appointChn 业务端制定渠道，具体渠道值参照渠道获取接口(目前只有此一个渠道)· yisuo String 否

2. 请求报文示例

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

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": "文本信息对比一致"
    }
}

5. 失败响应报文示例

{
     "status": 22013008,
     "success": false,
     "message": "身份核实认证失败,传入参数错误(姓名格式错误)"
}

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 信息未执行