数美-风险ip识别#
版权所有 翻版必究
风险ip识别#
调用时机#
在需要进行风险识别时调用本接口，例如：
- 新用户注册后，进行风险画像查询，用于新人红包、注册礼物等的差异化投放；
- 存量用户登录后，进行风险画像查询，用于日常活动运营的差异化投放；
- 活动奖励下发前，进行风险画像查询，例如随机红包、抽奖等概率性活动；
- 每日的例行查询，进行画像库或风控引擎的数据更新。
具体接口#
请求URL：#
| 集群 | URL | 支持产品列表 |
|---|---|---|
| 北京集群 | http://api-tianxiang-bj.fengkongcloud.com/tianxiang/v4 | 天象风险识别 |
| 新加坡集群 | http://api-tianxiang-xjp.fengkongcloud.com/tianxiang/v4 | 天象风险识别 |
| 法兰克福集群 | http://api-tianxiang-eur.fengkongcloud.com/tianxiang/v4 | 天象风险识别 |
| 弗吉尼亚集群 | http://api-tianxiang-fjny.fengkongcloud.com/tianxiang/v4 | 天象风险识别 |
请求方法：#
POST
字符编码：#
UTF-8
建议超时时间：#
1s
请求参数：#
放在HTTP Body中，采用Json格式，具体参数如下：
| 请求参数名 | 类型 | 参数说明 | 是否必传 | 规范 |
|---|---|---|---|---|
| accessKey | string | 接口认证密钥 用于权限认证，开通账号服务时由数美提供或使用开通邮箱登录数美后台右上角相关文档处查看 | 必传参数 | 数美分配 |
| data | json_object | 请求的数据内容 | 必传参数 | 请求的数据内容，最长10MB，详见data参数 |
| 请求参数名 | 类型 | 参数说明 | 是否必传 | 规范 |
|---|---|---|---|---|
| ip | string | 待检查的ip | 不能为空 | 该信息为客户要检查的ip |
返回结果#
放在HTTP Body中，采用Json格式，具体参数如下：
| 参数名称 | 参数类型 | 参数说明 | 是否必返 | 规范 |
|---|---|---|---|---|
| code | int | 返回码 | 是 | 1100：成功1901：QPS超限1902：参数不合法1903：服务失败1911：图片下载失败9101：无权限操作3000：运营商错误除message和requestId之外的字段，只有当code为1100时才会存在 |
| message | string | 返回码描述 | 是 | 和code对应：成功 QPS超限 参数不合法 服务失败 余额不足 无权限操作 |
| requestId | string | 请求标识 | 是 | 请求唯一标识，用于排查问题和后续效果优化，强烈建议保存 |
| profileExist | int | 设备画像存在 | 是 | 1：画像库中存在该设备信息0：画像库中不存在该设备信息 |
| ipLabels | json_object | ip标签信息 | 否 | 见下面详情内容，仅在ip传入且服务开通时返回 |
其中
1）ipLabels的详情内容
| 返回结果参数名 | 参数类型 | 参数说明 | 规范 |
|---|---|---|---|
| risk_ip | json_object | 风险ip | |
| ip_continent | json_object | ip归属洲信息 | |
| ip_country | json_object | ip归属国信息 | |
| ip_province | json_object | ip归属省信息 | |
| ip_city | json_object | ip归属城市信息 | |
| ip_owner | json_object | ip归属运营商信息 | |
| ip_longitude | json_object | ip归属地维度 | |
| ip_latitude | json_object | ip归属地经度 | |
| b_cmwap | json_object | 移动梦网 | |
| b_cgn | json_object | 运营商保留NAT |
其中risk_ip
| 返回结果参数名 | 参数类型 | 参数说明 | 规范 |
|---|---|---|---|
| risk_ip | int | 风险ip | 0：非风险ip 1：风险ip |
| risk_ip_last_ts | int | 风险ip命中时间 |
其中 ip_continent
| 返回结果参数名 | 参数类型 | 参数说明 | 规范 |
|---|---|---|---|
| ip_continent | string | 归属洲 |
其中 ip_country
| 返回结果参数名 | 参数类型 | 参数说明 | 规范 |
|---|---|---|---|
| ip_country | string | 归属国家 |
其中 ip_province
| 返回结果参数名 | 参数类型 | 参数说明 | 规范 |
|---|---|---|---|
| ip_province | string | 归属省份 |
其中 ip_city
| 返回结果参数名 | 参数类型 | 参数说明 | 规范 |
|---|---|---|---|
| ip_city | string | 归属城市 |
其中 ip_owner
| 返回结果参数名 | 参数类型 | 参数说明 | 规范 |
|---|---|---|---|
| ip_owner | string | 归属运营商 |
其中 ip_longitude
| 返回结果参数名 | 参数类型 | 参数说明 | 规范 |
|---|---|---|---|
| ip_longitude | float | 归属地纬度 |
其中 ip_latitude
| 返回结果参数名 | 参数类型 | 参数说明 | 规范 |
|---|---|---|---|
| ip_latitude | float | 归属地经度 |
其中 b_cmwap
| 返回结果参数名 | 参数类型 | 参数说明 | 规范 |
|---|---|---|---|
| b_cmwap | int | 移动梦网 | 0：非移动梦网 1：是移动梦网 |
其中 b_cgn
| 返回结果参数名 | 参数类型 | 参数说明 | 规范 |
|---|---|---|---|
| b_cgn | int | 运营商保留NAT | 0：非运营商保留NAT 1：是运营商保留NAT |
