实时风控(服务端)接入文档
2021.09.07 07:47:07
获取风控验证结果
请求地址:http://yb.dun.163.com/api/v1/s/p?{Token}
请求方式:GET(HTTP/HTTPS)
请求示例:http://yb.dun.163.com/api/v1/s/p?t=MFnEuDKOu3snyLC4qr4gdXMSdqmYqPAP-HfDZFiJ5ww7m1WWa7jD6meSMcvPpSlGT8B-MHmSBCb4IgqLfGdudw&a=1HEAAwsLAQMEDQ==
请求参数说明:Token来源于客户端,直接添加在请求URL的参数部分,即?符号后面即可
响应示例:
{
"code": 200,
"msg": "ok!",
"data": {
"finalGrade": 2,
"tags": [
{
"tag": "tag2-tag3",
"grade": 2
},
{
"tag": "tag2",
"grade": 1
}
]
}
}
响应参数说明:
字段 | 类型 | 是否必填 | 描述 |
---|---|---|---|
code | Int | 是 | 响应码,表示响应结果是否正常,具体值详见【响应码】定义 |
msg | String | 否 | 响应补充信息,正常响应时,该值为Null;异常情况时,表示异常说明 |
data | RiskData | 否 | 响应内容,正常响应时,必须填写;异常情况时,该值为Null。 |
其中,RiskData定义如下:
字段 | 类型 | 是否必填 | 描述 |
---|---|---|---|
finalGrade | int | 是 | 所有命中风险的等级中最高的等级,详见【风险等级】定义 |
tags | Set |
否 | 具体命中风险列表,无风险时为Null |
其中,TagData定义如下:
字段 | 类型 | 是否必填 | 描述 |
---|---|---|---|
grade | int | 是 | 具体命中风险的等级,详见【风险等级】定义 |
tag | String | 是 | 具体命中风险的名称 |
风险等级枚举值定义:
枚举值 | 描述 |
---|---|
0 | 正常 |
1 | 低危 |
2 | 中危 |
3 | 高危 |