数美天象产品API说明——IP风险画像#


版权所有 翻版必究#

风险IP画像#

调用时机#

在需要进行风险识别时调用本接口,例如:

  1. 新用户注册后,进行风险画像查询,用于新人红包、注册礼物等的差异化投放;
  2. 存量用户登录后,进行风险画像查询,用于日常活动运营的差异化投放;
  3. 活动奖励下发前,进行风险画像查询,例如随机红包、抽奖等概率性活动;
  4. 每日的例行查询,进行画像库或风控引擎的数据更新。

具体接口#

请求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格式,具体参数如下:

请求参数名类型参数说明是否必传规范
accessKeystring接口认证密钥
用于权限认证,开通账号服务时由数美提供或使用开通邮箱登录数美后台右上角相关文档处查看
必传参数数美分配
datajson_object请求的数据内容必传参数请求的数据内容,最长10MB,详见data参数
其中,data的内容如下:
请求参数名类型参数说明是否必传规范
ipstring当前业务事件发生时的客户端公网ipv4与ipv6地址必传参数非内网IP

返回结果#

放在HTTP Body中,采用Json格式,具体参数如下:

参数名称参数类型参数说明是否必返规范
codeint返回码1100:成功
1901:QPS超限
1902:参数不合法
1903:服务失败
9101:无权限操作
messagestring返回码描述和code对应:成功 QPS超限 参数不合法 服务失败 余额不足 无权限操作
requestIdstring请求标识请求唯一标识,用于排查问题和后续效果优化,强烈建议保存
ipLabelsjson_objectIP标签见下面详情内容,仅在IP字段传入时返回。

其中ipLabels的详情内容为:

返回结果参数名参数类型是否必反规范
b_cgnjson_object运营商保留IP
b_cmwapjson_object移动梦网IP
risk_ipjson_object是否为风险IP,风险IP是指通过数美风控策略和模型检测到的风险IP
b_secdialjson_object是否为秒拨IP,秒拨IP是指利用宽带频繁拨号上网所获取的IP
b_idcjson_object是否为机房IP,机房IP是指机房中心服务器使用的IP
b_proxyjson_object是否为代理IP,代理IP是指代理网络用户去取得网络信息的中转IP
ip_continentjson_objectIP归属洲
ip_countryjson_objectIP归属国家
ip_provincejson_objectIP归属省份
ip_cityjson_objectIP归属城市
ip_latitudejson_objectIP归属纬度
ip_longitudejson_objectIP归属经度
ip_ownerjson_objectIP运营商归属

其中risk_ip

返回结果参数名参数类型参数说明规范
risk_ipint业务风险IP0:非业务风险IP 1:业务风险IP
risk_ip_last_tsint业务风险IP命中时间

其中b_secdial

返回结果参数名参数类型参数说明规范
b_secdialint秒拨IP0:非秒拨IP 1:秒拨IP
b_secdial_last_tsint秒拨IP验证时间

其中b_idc

返回结果参数名参数类型参数说明规范
b_idcint机房IP0:非机房IP 1:机房IP
b_idc_last_tsint机房IP验证时间

其中b_proxy

返回结果参数名参数类型参数说明规范
b_proxyint代理IP0:非代理IP 1:代理IP
b_proxy_last_tsint代理IP验证时间

其中 ip_continent

返回结果参数名参数类型参数说明规范
ip_continentstring归属洲

其中 ip_country

返回结果参数名参数类型参数说明规范
ip_countrystring归属国家

其中 ip_province

返回结果参数名参数类型参数说明规范
ip_provincestring归属省份

其中 ip_city

返回结果参数名参数类型参数说明规范
ip_citystring归属城市

其中 ip_owner

返回结果参数名参数类型参数说明规范
ip_ownerstring归属运营商

其中 ip_longitude

返回结果参数名参数类型参数说明规范
ip_longitudefloat归属地经度

其中 ip_latitude

返回结果参数名参数类型参数说明规范
ip_latitudefloat归属地纬度

其中 b_cmwap

返回结果参数名参数类型参数说明规范
b_cmwapint移动梦网0:非移动梦网 1:是移动梦网

其中 b_cgn

返回结果参数名参数类型参数说明规范
b_cgnint运营商保留NAT0:非运营商保留NAT 1:是运营商保留NAT

示例:#

请求示例:#

{
"accessKey": "xxxxxxxxxxxxxxxxxxxxxxxxx",
"data": {
"ip": "116.237.65.34"
}
}

同步返回示例:#

{
"code": 1100,
"detail": null,
"devicePrimaryInfo": {},
"deviceRiskLabels": [],
"ipLabels": {
"b_cgn": {
"b_cgn": 0
},
"ip_city": {
"ip_city": "深圳"
},
"ip_country": {
"ip_country": "中国"
},
"ip_latitude": {
"ip_latitude": 22.5427
},
"ip_longitude": {
"ip_longitude": 114.01449
},
"ip_owner": {
"ip_owner": "China Telecom"
},
"ip_province": {
"ip_province": "广东"
},
"risk_ip": {
"risk_ip": 0
}
},
"message": "成功",
"profileExist": 1,
"requestId": "23e753672a69050d3dfb6db5d3259413",
"tokenProfileLabels": [],
"tokenRiskLabels": []
}

在线咨询