数美天网-渠道假量识别#
版权所有 翻版必究
渠道假量识别#
具体接口#
请求URL：#
| 集群 | URL | 支持产品列表 |
|---|---|---|
| 北京 | http://api-skynet-bj.fengkongcloud.com/v4/event | 天网风险识别 |
| 美国（弗吉尼亚） | http://api-skynet-fjny.fengkongcloud.com/v4/event | 天网风险识别 |
| 新加坡 | http://api-skynet-xjp.fengkongcloud.com/v4/event | 天网风险识别 |
| 欧洲（法兰克福） | http://api-skynet-eur.fengkongcloud.com/v4/event | 天网风险识别 |
请求方法：#
POST
字符编码：#
UTF-8
建议超时时间：#
1s
请求参数：#
请求body = 通用请求参数 + 事件特有参数 （放在data字段下）
通用的请求参数：#
放在HTTP Body中，采用Json格式，具体参数如下：
| 参数名称 | 类型 | 参数说明 | 是否必传 | 规范 |
|---|---|---|---|---|
| accessKey | string | 接口认证密钥 用于权限认证，开通账号服务时由数美提供或使用开通邮箱登录数美后台右上角相关文档处查看 | 必传参数 | 数美分配 |
| appId | string | 应用ID，用于区分相同公司的不同应用 | 必传参数 | 该参数传递值可与数美协商 |
| eventId | string | 事件ID，用于标识事件类型。 | 必传参数 | 不同的事件对应不同的策略，不同的事件输入参数可能会有细微的差别，请对应按照各事件详细传参说明 |
| data | json_object | 请求的数据内容，事件特有参数可以放入data下传入 | 必传参数 | 请求的数据内容，最长10MB，详见data参数 |
| 参数名称 | 类型 | 参数说明 | 是否必传 | 规范 |
|---|---|---|---|---|
| ip | string | 当前业务事件发生时的客户端公网ipv4地址 | 必传参数 | 非内网ip |
| timestamp | int64 | 当前业务事件发生时的时间戳，单位为毫秒（ms） | 必传参数 | |
| deviceId | string | 数美设备指纹标识，由数美SDK生成 | 强烈建议 | 数美设备指纹标识，用于用户行为分析。 注： 1. 接入数美SDK前的版本，无法获取到deviceId的情况下，deviceId传空“”即可； 2. 直接传输getDeviceId获取到的原始字段，不需要解密 |
| os | string | 应用端操作系统类型 | 强烈建议 | 可选值：android、harmony、ios、weapp、web、aliapp：支付宝小程序、ttapp：抖音小程序、tmapp：天猫小程序 |
| userAgent | string | 用户代理 | 强烈建议 | |
| extra | json | 用户自定义数据 | 建议 | 如无必要，不传 |
| passThrough | json | 用户自定义透传字段 | 建议 | 如无必要，不传 |
返回结果#
放在HTTP Body中，采用Json格式，具体参数如下：
| 参数名称 | 类型 | 参数说明 | 是否必返 | 规范 |
|---|---|---|---|---|
| code | int | 返回码 | 是 | 1100：成功1901：QPS超限1902：参数不合法1903：服务失败1911：图片下载失败9101：无权限操作3000：运营商错误除message和requestId之外的字段，只有当code为1100时才会存在 |
| message | string | 返回码描述 | 是 | 和code对应：成功 QPS超限 参数不合法 服务失败 余额不足 无权限操作 |
| requestId | string | 请求标识 | 是 | 请求唯一标识，用于排查问题和后续效果优化，强烈建议保存 |
| riskevel | string | 当前事件的处置建议 | 是 | PASS：通过REVIEW：审核REJECT：拒绝VERIFY:验证 |
| detail | json_object | 风险详情信息，详情见下文 | 是 | 详见detail结果详情 |
| 返回结果参数名 | 参数类型 | 参数说明 | 规范 |
|---|---|---|---|
| description | string | 当前事件的风险描述 | |
| model | string | 规则标识，命中的最高优先级规则标识 | |
| hits | Json array | 事件命中的所有规则标识 | hits中每个字段都是一个object，详见hits结果详情 |
| ip_country | string | ip归属地国家 | |
| ip_province | string | ip归属地省份 | |
| ip_city | string | ip归属地城市 | |
| smid | string | 设备唯一标识 | 需要传入deviceId字段且联系数美开通配置后，才会返回该字段 |
| 返回结果参数名 | 参数类型 | 参数说明 | 规范 |
|---|---|---|---|
| description | string | 当前事件的风险描述 | |
| model | string | 规则标识 | |
| riskLevel | string | 当前事件的处置建议 | PASS：通过REVIEW：审核REJECT：拒绝VERIFY:验证 |
事件列表#
| 行业 | 场景 | 事件 | eventId | 规范 |
|---|---|---|---|---|
| 通用 | 渠道流量反作弊 | 激活 | activation | 参数详情 |
事件详细API#
激活 #
| 参数名称 | 类型 | 参数说明 | 是否必传 | 规范 |
|---|---|---|---|---|
| 基础参数 | 需要满足基础参数的配置要求 | |||
| advertisingId | string | 广告计费的设备ID | 必传参数 | 一般是安卓的IMEI或苹果设备的IDFA。可以传入哈希值 |
| apputm | string | 本次激活来自的渠道标识 | 必传参数 | 客户自定义字段 |
