/data/check_hack_user

1.接口描述

该API的功能是根据身份证号或手机号查验用户是否曾经试图使用照片、视频、3D模型,冒充他人欺骗人脸比对

请求方式

POST

请求 URL

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

2.请求参数

字段 类型 必需 描述
api_id string API 账户
api_secret string API 密钥
phone_number string 手机号
id_number string 身份证号

注:

请求参数 phone_number ,和id_number 二选一。

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

3.返回参数

正常响应

字段 类型 说明
request_id string 本次请求的id
status string 状态,正常为 OK,其他值表示失败,详见错误码
result int 查验结果,值为“1”或“2”,“1”表示是hack用户,“2”表示不是hack用户

收费情况:

result 说明 是否收费
1 是hack用户
2 不是hack用户

返回样例:

{
  "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 无调用权限
403 OUT_OF_QUOTA 调用次数超出限额
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/check_hack_user?api_id=ID&api_secret=SECRET" -F id_number=1010000000000001

results matching ""

    No results matching ""