身份证四要素验证(有效期校验)
接口地址:http://tianyan.apistd.com/v2/idcard4/check请求方法:post
请求参数 (Query)
参数名 | 类型 | 必须 | 描述 |
---|---|---|---|
key | string | 是 | 请求 AccessKey, 请在控制台中查看 |
idcard | string | 是 | 身份证号码 |
name | string | 是 | 姓名 |
begin | string | 是 | 身份证有效期开始日期,yyyyMMdd, eg:20191111 |
end | string | 否 | 身份证有效期结束日期,格式同上,长期有效可以不填 |
返回参数 (Body)
参数名 | 类型 | 描述 |
---|---|---|
success | boolean | 接口请求成功标识,true为成功,false为失败,失败情况下,会有对应描述和状态码 |
code | number | 成功为200,其它为失败状态码 |
msg | string | code对应的说明描述 |
data | object | 验证结果详细信息 |
order_no | string | 订单号 |
result | string | 验证结果,一致、不一致、条件不符合要求(身份证号非法) |
sex | string | 性别 |
birthday | string | 生日 |
address | string | 籍贯 |
错误码
错误码 | 描述 |
---|---|
1001 | 其他,以实际返回为准 |
400 | 参数错误 |
404 | 请求资源不存在 |
500 | 系统内部错误,请联系服务商 |
501 | 第三方服务异常 |
601 | 服务商未开通接口权限 |
602 | 账号停用 |
603 | 余额不足请充值 |
604 | 接口停用 |