数美-风险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待检查的ip不能为空该信息为客户要检查的ip

返回结果#

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

参数名称参数类型参数说明是否必返规范
codeint返回码1100:成功
1901:QPS超限
1902:参数不合法
1903:服务失败
1911:图片下载失败
9101:无权限操作
3000:运营商错误
除message和requestId之外的字段,只有当code为1100时才会存在
messagestring返回码描述和code对应:成功 QPS超限 参数不合法 服务失败 余额不足 无权限操作
requestIdstring请求标识请求唯一标识,用于排查问题和后续效果优化,强烈建议保存
profileExistint设备画像存在1:画像库中存在该设备信息0:画像库中不存在该设备信息
ipLabelsjson_objectip标签信息见下面详情内容,仅在ip传入且服务开通时返回

其中

1)ipLabels的详情内容

返回结果参数名参数类型参数说明规范
risk_ipjson_object风险ip
ip_continentjson_objectip归属洲信息
ip_countryjson_objectip归属国信息
ip_provincejson_objectip归属省信息
ip_cityjson_objectip归属城市信息
ip_ownerjson_objectip归属运营商信息
ip_longitudejson_objectip归属地维度
ip_latitudejson_objectip归属地经度
b_cmwapjson_object移动梦网
b_cgnjson_object运营商保留NAT

其中risk_ip

返回结果参数名参数类型参数说明规范
risk_ipint风险ip0:非风险ip 1:风险ip
risk_ip_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": {
"tokenId": "ceshizhanghao",
"deviceId": "ceshideviceId",
"phone": "ceshiphone"
}
}

同步返回示例:#

{
"code": 1100,
"message": "成功",
"profileExist": 1,
"requestId": "7a5445716f0581c2ab1d381a6af4d1b8",
"ipLabels": {
"risk_ip": {
"risk_ip": 1,
"risk_ip_last_ts": 1587711321232
},
"ip_continent": {
"ip_continent": "亚洲"
},
"ip_country": {
"ip_country": "中国"
},
"ip_province": {
"ip_province": "香港"
},
"ip_city": {
"ip_province": "浦东区"
},
"ip_owner": {
"ip_owner": "移动"
},
"ip_longitude": {
"ip_longitude": 39.90279
},
"ip_latitude": {
"ip_latitude": 39.90279
},
"b_cmwap": {
"b_cmwap": "xxx"
},
"b_cgn": {
"b_cgn": "xxx"
}
}
}

在线咨询