#
数美天象产品API说明——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 | 当前业务事件发生时的客户端公网ipv4与ipv6地址 | 必传参数 | 非内网IP |
type | string | 标签类型 | 非必传参数 | IP标签 可选值: RISKIP: 风险IP BPROXY: 代理IP DEFAULT: 默认返回全部标签 支持传入多个一级风险标签以下划线_分隔 不传type参数默认返回全部标签 |
返回结果#
放在HTTP Body中,采用Json格式,具体参数如下:
参数名称 | 参数类型 | 参数说明 | 是否必返 | 规范 |
---|---|---|---|---|
code | int | 返回码 | 是 | 1100 :成功1901 :QPS超限1902 :参数不合法1903 :服务失败9101 :无权限操作 |
message | string | 返回码描述 | 是 | 和code对应:成功 QPS超限 参数不合法 服务失败 余额不足 无权限操作 |
requestId | string | 请求标识 | 是 | 请求唯一标识,用于排查问题和后续效果优化,强烈建议保存 |
ipLabels | json_object | IP标签 | 否 | 见下面详情内容,仅在IP字段传入时返回。 |
其中ipLabels的详情内容为:
返回结果参数名 | 参数类型 | 是否必反 | 规范 |
---|---|---|---|
b_cgn | json_object | 否 | 运营商保留IP |
b_cmwap | json_object | 否 | 移动梦网IP |
risk_ip | json_object | 否 | 是否为风险IP,风险IP是指通过数美风控策略和模型检测到的风险IP |
b_secdial | json_object | 否 | 是否为秒拨IP,秒拨IP是指利用宽带频繁拨号上网所获取的IP |
b_idc | json_object | 否 | 是否为机房IP,机房IP是指机房中心服务器使用的IP |
b_proxy | json_object | 否 | 是否为代理IP,代理IP是指代理网络用户去取得网络信息的中转IP |
ip_continent | json_object | 否 | IP归属洲 |
ip_country | json_object | 否 | IP归属国家 |
ip_province | json_object | 否 | IP归属省份 |
ip_city | json_object | 否 | IP归属城市 |
ip_latitude | json_object | 否 | IP归属纬度 |
ip_longitude | json_object | 否 | IP归属经度 |
ip_owner | json_object | 否 | IP运营商归属 |
其中risk_ip
返回结果参数名 | 参数类型 | 参数说明 | 规范 |
---|---|---|---|
risk_ip | int | 业务风险IP | 0 :非业务风险IP 1 :业务风险IP |
risk_ip_last_ts | int | 业务风险IP命中时间 |
其中b_secdial
返回结果参数名 | 参数类型 | 参数说明 | 规范 |
---|---|---|---|
b_secdial | int | 秒拨IP | 0 :非秒拨IP 1 :秒拨IP |
b_secdial_last_ts | int | 秒拨IP验证时间 |
其中b_idc
返回结果参数名 | 参数类型 | 参数说明 | 规范 |
---|---|---|---|
b_idc | int | 机房IP | 0 :非机房IP 1 :机房IP |
b_idc_last_ts | int | 机房IP验证时间 |
其中b_proxy
返回结果参数名 | 参数类型 | 参数说明 | 规范 |
---|---|---|---|
b_proxy | int | 代理IP | 0 :非代理IP 1 :代理IP |
b_proxy_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 |