/data/verify_id_name

1.接口描述

该API的功能是验证二要素(身份证号和姓名)是否一致

请求方式

POST

请求 URL

https://cloudapi.linkface.cn/data/verify_id_name

2.请求参数

字段 类型 必需 描述
api_id string API账号
api_secret string API密钥
name string 姓名
id_number string 身份证号

所有中文和特殊字符必需以UTF-8编码转义。

3.返回参数

正常响应

字段 类型 说明
request_id string 本次请求的id
status string 状态,正常为 OK,异常见错误响应
result int 验证结果,详情见下表

收费情况

result 说明 是否收费
1 身份证号和姓名一致
2 身份证号和姓名不一致
3 查无此身份证号

返回样例

{
  "request_id": "TID2af751b4bff24be781d60af10bf84101",
  "status": "OK",
  "result": 1
}

4.错误码

状态码 status 字段 说明
400 ENCODING_ERROR 参数非UTF-8编码
400 INVALID_ARGUMENT 请求参数错误,具体原因见 reason 字段内容
401 UNAUTHORIZED 账号或密钥错误
401 KEY_EXPIRED 账号过期,具体原因见 reason 字段内容
403 RATE_LIMIT_EXCEEDED 调用频率过高
403 NO_PERMISSION 无调用权限
404 NOT_FOUND 请求路径错误
500 DATA_SERVER_ERROR 数据服务异常
500 INTERNAL_ERROR 内部服务异常

返回样例

{
  "status": "INVALID_ARGUMENT",
  "reason": "argument 'name': not found",
  "request_id": "TID2af751b4bff24be781d60af10bf84101"
}
{
  "status": "INVALID_ARGUMENT",
  "reason": "Invalid id_number",
  "request_id": "TIDe43421b4631844049c8780d24a86585b"
}

5.输入示例

  • cURL 样例
curl -X POST "https://cloudapi.linkface.cn/data/verify_id_name?api_id=ID&api_secret=SECRET" \
  -F name="孙悟空" -F id_number=1010000000000001

results matching ""

    No results matching ""