最近更新时间：2021.12.16 18:19:53
首次发布时间：2021.12.16 18:01:18
| 字段名称 | 字段类型 | 字段说明 |
|---|---|---|
| AppId | int | 应用ID，同一个商户可能有多个产品，为了区分每个产品而生成一个产品唯一标识。在火山引擎控制台，如果已有想要接入风险识别的应用，直接将该应用的ID的值赋给AppId字段，如果没有则可创建新应用 |
| Service | string | 要请求的服务类型，如:login表示登录检测，register表示注册检测 |
| Parameters | string | JSON格式，表示要传的参数上下文 |
参数列表
| 字段名称 | 字段类型 | 字段说明 |
|---|---|---|
| RequestId | string | 本次请求的唯一标识 |
| Code | int | 请求返回码，为0表示成功，不为0表示异常 |
| Message | string | 请求返回描述，和请求返回码对应 |
| Data | Data | 返回风险结果数据 |
| Data | ||
| Score | int | 当前事件的风险评分，分数越高，风险越大。范围为：0、300、600、900 |
| Tags | json array | 当前事件命中的风险标签/风险详情 |
| Detail | string | 风险详情信息，JSON格式 |
返回样例
用户发送的每次接口调用请求，无论成功与否，系统都会返回一个唯一识别码RequestId给用户。
{ "Result": { "RequestId": "2021011016095301020405020334544FB2", "Code": 0, // 0表示请求成功 "Message": "success", "Data": { "Score":900, "Tags":["11001","11003"], "Detail":"{"11001":{"Score":"900"},"11003":{"Score":"300"}}" } } }
| code | 对应的message | 含义描述 |
|---|---|---|
| 0 | success | 请求正常。 |
| 1001 | invalid parameters | 参数不合法。 |
| 1002 | auth failed | 认证失败。 |
| 1003 | no permission | 权限不足，服务未开通或已到期。 |
| 1004 | qps limit | QPS超过已购规格，限流。 |
| 1005 | insufficient balance | 余额/余量不足 |
| 2000 | internal error | 内部服务器错误。 |
score字段表示当前事件的风险评分，分数越高，风险越大。范围为：[0, 1000]
score 字段值的业务含义根据火山引擎风控团队经验可参考如下（实际使用可根据自身业务运营灵活选择）：
| 值区间 | 风险等级 | 描述 |
|---|---|---|
| 0 | 低风险 | 可放过 |
| 300 | 中风险 | 可标记用户观察 |
| 600 | 中高风险 | 可进一步安全验证或限制高危业务使用权限 |
| 900 | 高风险 | 可限制高危业务使用权限 |
Code | 标签 | 说明 |
|---|---|---|
[]（空array） | 正常 | 正常 |
11001 | 账户黑名单 | 命中账户手机号、设备等黑名单 |
11002 | 账户行为风险 | 通过账号行为模型，识别到手机号行为存在风险 |
11003 | 手机号风险 | 通过账户手机号状态识别到存在异常风险，如非法手机号、虚拟号段等 |
11004 | 邮箱域名异常 | 通过账户邮箱域名黑名单及状态识别到存在异常风险 |
11005 | 账号异常 | 通过账号IP、设备环境等参数识别到账号异常风险 |
11006 | 批量注册账号风险 | 通过设备多开、改机等黑产作弊手段大批量注册账号 |
11007 | 用户小号风险 | 识别到真人用户手动注册多个平台小号 |
11008 | 杀猪盘账号 | 通过关联账号历史行为及杀猪盘特征，识别到的杀猪盘欺诈账户 |
11009 | 广告导流账号 | 通过关联账号历史行为及广告导流特征，识别到的广告导流欺诈的账户 |
13001 | IP环境异常 | IP 为非常用 IP 或恶意 IP 段 |
13002 | IP黑名单 | IP命中风险黑名单 |
13003 | IP行为异常 | IP行为异常，存在作弊风险 |
13004 | IP异常聚集 | IP异常聚集，存在团伙作弊风险 |
14001 | 设备黑名单 | 高危设备，主要表现为高危设备风险标签评分，黑产特征设备等类型 |
14002 | 设备聚集异常 | 设备在ip、环境等维度表现聚集异常 |
14003 | 设备行为异常 | 设备历史上存在众包、刷单等行为异常 |
14004 | 设备环境异常 | 设备环境存在作弊情况，包括脚本环境、模拟器等 |
15001 | 手机号黑名单 | 命中手机号黑名单 |
15002 | 手机号状态异常 | 通过手机号状态及格式存在异常，如非法手机号、虚拟号段等 |
15003 | 手机号行为异常 | 通过手机号行为模型识别到存在异常行为风险 |
15004 | 手机号异常聚集 | 通过手机号群组模型识别到存在异常聚集或团伙风险 |
15005 | 杀猪盘手机号 | 通过手机号黑名单及杀猪盘模型，识别到存在杀猪盘欺诈风险 |
15006 | 广告导流手机号 | 通过手机号黑名单及广告导流模型，识别到存在广告导流欺诈风险 |
22001 | 营销活动薅羊毛 | 通过营销活动行为和记录，识别到存在机器、脚本等薅羊毛作弊风险 |
22002 | 营销活动真人众包 | 通过营销活动行为和记录，识别到存在真人众包薅羊毛风险 |
23001 | 内容欺诈风险 | 通过发文、点赞等场景行为和历史记录，识别到欺诈风险 |
23002 | 内容导流风险 | 通过发文、点赞等场景行为和历史记录，识别到存在导流风险 |
23003 | 虚假刷量风险 | 通过发文、点赞等场景行为和历史记录，识别到存在虚假作弊刷量风险 |
24001 | 疑似爬虫风险 | 通过内容访问记录及行为，识别到疑似非真人用户爬虫风险 |
25001 | 充值欺诈风险 | 通过充值行为及历史记录识别存在欺诈风险 |
25002 | 异常退款风险 | 通过充值行为及历史记录识别存在异常退款风险 |
26001 | 异常渠道激活 | 通过众包、虚拟设备、机器脚本等方式伪造设备激活 |
26002 | 异常广告点击 | 通过众包、虚拟设备、机器脚本等方式伪造设备点击 |
27001 | 疑似黄牛党 | 通过电商行为及历史记录识别疑似黄牛党 |
28001 | 疑似录播 | 通过伪造设备虚假直播 |
字段名称 | 字段类型 | 字段说明 |
|---|---|---|
对应返回的风险标签 （Tags中返回的内容） | json | 具体的风险标签值说明， 如："Detail":"{"11001":{"Score":"900"},"11003":{"Score":"300"}}" 目前只包含风险标签对应的风险分，后续可能会继续新增标签对应的内容 |
Detail中Score参数说明
Score值 | Detail返回值 |
|---|---|
0 | 空字符串，"{ }" |
300、600、900 | 根据返回的Tags，给出每个标签具体的风险分值 "{"11001":{"Score":"900"},"11003":{"Score":"300"}}" |