聚合数据

涉外身份证实名

  • 数据类型: 金融科技
  • 接口状态: 正常
  • 已连接App的数量: 5
  • 描述: 涉外身份证实名认证,支持华侨护照、港澳居民来往内地通行证、外国人永久居留身份证

接口地址: http://apis.juhe.cn/foreign_idcard_verify/query

支持格式: json

请求方式: GET/POST

请求示例: http://apis.juhe.cn/foreign_idcard_verify/query?key=您申请的appkey&realname=张三&idcard=411521********5724&nation=CHN&id_type=516&mode=0

请求参数:

名称 类型 必填 说明
key string 在个人中心->我的数据,接口名称上方查看
realname string 姓名
idcard string 证件号码
image string 人像,Base64字符串,5KB-40KB以内
nation string 国家名英文缩写,除港澳以外参照ISO3166标准,华侨和港澳人员使用CHN
id_type string 证件类型,414-华侨护照,516-港澳居民来往内地通行证,553-外国人永久居留身份证
mode string 认证模式,0-二要素核验(姓名+证件号),1-人像三要素核验(姓名+证件号+人像)

返回字段:

名称 类型 说明
error_code int 状态码,成功时返回0
reason string 状态信息
result object 返回结果集
result.text_verify_code string 认证文本信息匹配比对结果状态码(0-文本信息比对一致,1-参数错误,7-文本信息比对不一致,8-文本信息比对一致但证件失效,W-系统内部错误,X-未执行)
result.text_verify_msg string 认证文本信息匹配比对结果描述,与text_verify_code对应
result.portrait_verify_code string 人像比对结果状态码(0-同一人,1-比对不是同一人,D-人像数据未录入,E-现场照片质量不足或格式不对,H-活体检测控件版本过期或检测数据校验失败,W-系统内部错误,X-未执行)
result.portrait_verify_msg string 人像比对结果描述,与portrait_verify_code对应
result.household_verify_code string 户籍状态标识(0-无户籍,1-有户籍,X-未执行或不确定有无户籍)
result.household_verify_msg string 户籍状态标识描述,与household_verify_code对应
result.orderid string 请求流水单号

JSON返回示例:

{
    "reason": "成功",
    "result": {
        "text_verify_code": "0",
        "text_verify_msg": "文本信息比对一致",
        "portrait_verify_code": "0",
        "portrait_verify_msg": "同一人",
        "household_verify_code": "1",
        "household_verify_msg": "有户籍",
        "orderid": "JH550202005140915360457"
    },
    "error_code": 0
}

XML返回示例:


          

备注:涉外身份(姓名、证件号、人像)实名认证

服务级错误码参照(error_code):

错误码 说明
255101 参数错误
255103 校验失败
255106 数据源异常
255107 数据源超时

系统级错误码参照:

错误码 说明
10001 错误的请求KEY
10002 该KEY无请求权限
10003 KEY过期
10004 错误的OPENID
10005 应用未审核超时,请提交认证
10007 未知的请求源
10008 被禁止的IP
10009 被禁止的KEY
10011 当前IP请求超过限制
10012 请求超过次数限制
10013 测试KEY超过请求限制
10014 系统内部异常(调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失)
10020 接口维护
10021 接口停用

错误码格式说明(示例:200201):

2 002 01
服务级错误(1为系统级错误) 服务模块代码(即数据ID) 具体错误代码

《涉外身份证实名》资费说明:

等级 价格(元) 请求次数

其他相关内容:

内容 详细
接口测试 API测试工具
技术支持 info@juhe.cn
联系电话 0512-62391880
QQ交流群 264591694
在线客服QQ 1794844675
商务合作QQ 603866358