最近更新时间:2022.12.29 10:57:54
首次发布时间:2022.12.29 10:57:54
字段名称 | 字段类型 | 字段说明 |
---|---|---|
AppId | int | 应用ID,同一个商户可能有多个产品,为了区分每个产品而生成一个产品唯一标识。在火山引擎控制台,如果已有想要接入风险识别的应用,直接将该应用的ID的值赋给AppId字段,如果没有则可创建新应用 |
Service | string | 要请求的服务类型,如:login表示登录检测,register表示注册检测 |
Parameters | string | JSON格式,表示要传的参数上下文 |
参数列表
字段名称 | 字段类型 | 字段说明 |
---|---|---|
RequestId | string | 本次请求的唯一标识 |
Code | int | 请求返回码,为0表示成功,不为0表示异常 |
Message | string | 请求返回描述,和请求返回码对应 |
Data | Data | 返回风险结果数据 |
Data | ||
Decision | string | 当前决策结果,包括BLOCK和PASS |
Detail | string | 风险详情信息,往往包含相应的决策所需操作,当决策为BLOCK的时候需要关注 |
这里提供的是决策【建议】,需要甲方在游戏中实施
返回样例
用户发送的每次接口调用请求,无论成功与否,系统都会返回一个唯一识别码RequestId给用户。
{ "Result": { "RequestId": "2021011016095301020405020334544FB2", "Code": 0, // 0表示请求成功 "Message": "success", "Data": { "Decision": "BLOCK", // BLOCK or PASS "Detail": "review" // 预留的风险详情字段 } } }
返回code的说明:
code | 对应的message | 含义描述 |
---|---|---|
0 | success | 请求正常。 |
1001 | invalid parameters | 参数不合法。 |
1002 | auth failed | 认证失败。 |
1003 | no permission | 权限不足,服务未开通或已到期。 |
1004 | qps limit | QPS超过已购规格,限流。 |
1005 | insufficient balance | 余额/余量不足 |
2000 | internal error | 内部服务器错误。 |