黑名单接口

/blacklist/isBlacklist接口是黑名单查询接口,支持名字、手机号、证件号单条件查询或多条件组合查询。

调用该接口查询黑名单时,请注意:

  • 查询黑名单会根据命中量计费

  • 提交post请求时用表单方式提交(application/x-www-form-urlencoded),非json

POST请求表单参数

名称

类型

最大长度

是否必选

示例值

描述

name

String

64

okok

用户名字

mobile

String

16

0999999999

用户手机号

credential_no

String

32

1111581111

用户证件号

说明:

  • 名字的顺序为firstname[·middlename]·lastname,·号分隔

  • name、mobile、credential_no不能同时为空,至少需要有一个参数

  • 参数越多则黑名单命中概率越高

返回数据

名称

类型

示例值

描述

success

boolean

true

请求是否成功

code

String

verify_sign_fail

请求状态码

msg

String

鉴权失败(s1008)

状态码的描述

data

String

{"isHit": "HIT/NOT_HIT"}

请求返回的数据

requestId

String

b2fa4a5a610d4c2fb716391595fadd02

请求Id,可用于debug

说明:

  • 只有code0并且dataMap中key为isHit的值为HIT,才是命中

示例

正常返回示例

JSON 格式

{
    "success": true,
    "code": "0",
    "msg": "",
    "data": {
        "isHit": "HIT"
    },
    "requestId": "03cd54ebe6ee40c7bed8ec346974337d"
}

Last updated

Was this helpful?