风险画像 2.0 IP 版

API 方式#

Base URL#

中国节点：https://cn.apitd.net/verification/persona/ip/v1

API#

URL	请求方式	Content-Type	输出格式	字符集
api-base-url?partner_code=xxx&partner_key=xxx	POST	application/json	JSON	UTF-8

示例：https://cn.apitd.net/verification/persona/ip/v1?partner_code=test_code&partner_key=test_key

认证参数

字段	类型	含义	建议	备注
partner_code	String	合作方标识	必须	由 TD 分配
partner_key	String	合作方密钥	必须	由 TD 分配

请求参数#

字段	类型	含义	建议	备注
ip	String	IP 地址	必须	支持 IPV4 和 IPV6

请求示例#

JSON

{
    "ip": "123.157.153.130"
}

响应参数#

字段	类型	含义	备注
code	Integer	API 状态码
message	String	状态信息	在 API 异常状态下会输出具体的异常原因
sequence_id	String	响应唯一码	用于跟踪每次请求记录的唯一标识
ip_risk_score	Integer	IP 风险分	范围为 0 - 100
ip_continent	String	IP 归属大洲
ip_country	String	IP 归属国家
ip_province	String	IP 归属省份
ip_city	String	IP 归属城市
ip_district	String	IP 归属区县
ip_longitude	String	IP 经度	WGS84
ip_latitude	String	IP 纬度	WGS84
ip_owner	String	IP owner
ip_operator	String	IP 运营商
ip_type	String	IP 类型	枚举值： reserved：保留 IP education：教育机构 base_station：普通基站 base_station_shared：基站公共出口 data_center：机房 / 数据中心 dedicated_network：专用网络出口 enterprise：企业宽带 public_location：公共场所 home：家庭宽带 dormant：沉寂状态 unidentified：未识别
is_proxy	Boolean	是否有代理行为	枚举值： true：是 false：否
ip_risk_labels	Array	IP 风险行为标签	fraudulent_registration：垃圾注册 coupon_abuse：薅羊毛 tampered_device：篡改设备 IP fake_device：虚假设备 IP high_risk_device：高危设备 IP sms_bombing：短信轰炸 scalping：黄牛 spam：垃圾信息 suspicious_attacks_ip：疑似攻击行为 IP suspicious_fake_phone：疑似虚假号码 IP suspicious_high_risk_status_phone：疑似高危状态号码 IP high_risk_phone：高风险手机号 IP

API 状态码

code	含义
200	成功
301	未购买此服务
302	流量已被禁用
303	流量不足
304	服务已过期
305	日流量已封顶
9600	系统错误
9601	IP 格式非法
9606	参数非法

响应示例#

JSON

{
    "code": 200,
    "message": "成功",
    "sequence_id": "1724745058326827S3A8804983110052",
    "ip_risk_score": 89,
    "ip_continent": "亚洲",
    "ip_country": "中国",
    "ip_province": "浙江省",
    "ip_city": "杭州市",
    "ip_district": "余杭区",
    "ip_longitude": "119.987"

URL

请求方式

Content-Type

输出格式

字符集

api-base-url?partner_code=xxx&partner_key=xxx

POST

application/json

JSON

UTF-8

字段

类型

含义

建议

备注

partner_code

String

合作方标识

必须

由 TD 分配

partner_key

String

合作方密钥

必须

由 TD 分配

字段

类型

含义

建议

备注

String

IP 地址

必须

支持 IPV4 和 IPV6

字段

类型

含义

备注

code

Integer

API 状态码

message

String

状态信息

在 API 异常状态下会输出具体的异常原因

sequence_id

String

响应唯一码

用于跟踪每次请求记录的唯一标识

ip_risk_score

Integer

IP 风险分

范围为 0 - 100

ip_continent

String

IP 归属大洲

ip_country

String

IP 归属国家

ip_province

String

IP 归属省份

ip_city

String

IP 归属城市

ip_district

String

IP 归属区县

ip_longitude

String

IP 经度

WGS84

ip_latitude

String

IP 纬度

WGS84

ip_owner

String

IP owner

ip_operator

String

IP 运营商

ip_type

String

IP 类型

枚举值：
reserved：保留 IP
education：教育机构
base_station：普通基站
base_station_shared：基站公共出口
data_center：机房 / 数据中心
dedicated_network：专用网络出口
enterprise：企业宽带
public_location：公共场所
home：家庭宽带
dormant：沉寂状态
unidentified：未识别

is_proxy

Boolean

是否有代理行为

枚举值：
true：是
false：否

ip_risk_labels

Array

IP 风险行为标签

fraudulent_registration：垃圾注册
coupon_abuse：薅羊毛
tampered_device：篡改设备 IP
fake_device：虚假设备 IP
high_risk_device：高危设备 IP
sms_bombing：短信轰炸 scalping：黄牛 spam：垃圾信息 suspicious_attacks_ip：疑似攻击行为 IP suspicious_fake_phone：疑似虚假号码 IP suspicious_high_risk_status_phone：疑似高危状态号码 IP high_risk_phone：高风险手机号 IP

code

含义

200

成功

301

未购买此服务

302

流量已被禁用

303

流量不足

304

服务已过期

305

日流量已封顶

9600

系统错误

9601

IP 格式非法

9606

参数非法

{ "code": 200, "message": "成功", "sequence_id": "1724745058326827S3A8804983110052", "ip_risk_score": 89, "ip_continent": "亚洲", "ip_country": "中国", "ip_province": "浙江省", "ip_city": "杭州市", "ip_district": "余杭区", "ip_longitude": "119.987"