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

请求示例

{
    "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
ip_decline_count_30d	Integer	近 30 天 IP 拒绝量
ip_decline_rate_30d	Integer	近 30 天 IP 拒绝率	范围为 0 - 100
ip_review_count_30d	Integer	近 30 天 IP 核验量
ip_review_rate_30d	Integer	近 30 天 IP 核验率	范围为 0 - 100
ip_device_count_30d	Integer	近 30 天 IP 关联设备数量
ip_risk_device_count_30d	Integer	近 30 天 IP 关联风险设备数量
ip_risk_device_rate_30d	Integer	近 30 天 IP 关联风险设备占比	范围为 0 - 100
ip_phone_count_30d	Integer	近 30 天 IP 关联手机号数量
ip_risk_phone_count_30d	Integer	近 30 天 IP 关联风险手机号数量
ip_risk_phone_rate_30d	Integer	近 30 天 IP 关联风险手机号占比	范围为 0 - 100

API 状态码

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",
    "ip_latitude": "30.384272",
    "ip_owner": "中国联通",
    "ip_operator": "中国联通",
    "ip_type": "enterprise",
    "is_proxy": false,
    "ip_risk_labels": [
        "fake_device",
        "tampered_device",
        "high_risk_device"
    ],
    "ip_decline_count_30d": 3,
    "ip_decline_rate_30d": 7,
    "ip_review_count_30d": 3,
    "ip_review_rate_30d": 7,
    "ip_device_count_30d": 5,
    "ip_risk_device_count_30d": 2,
    "ip_risk_device_rate_30d": 40,
    "ip_phone_count_30d": 2,
    "ip_risk_phone_count_30d": 0,
    "ip_risk_phone_rate_30d": 0
}