国际 IP 风险画像专业版

API 方式#

Base URL#

新加坡节点：https://sg.apitd.net/verification/persona/ip/pro/v1
美国节点：https://us.apitd.net/verification/persona/ip/pro/v1
德国节点：https://de.apitd.net/verification/persona/ip/pro/v1

API#

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

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

认证参数

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

请求参数#

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

请求示例#

JSON

{
    "ip": "210.20.10.33"
}

响应参数#

字段	类型	含义	备注
code	Integer	API 状态码
message	String	状态信息	在 API 异常状态下会输出具体的异常原因
sequence_id	String	响应唯一码	用于跟踪每次请求记录的唯一标识
continent	String	大洲
country_id	String	国家编码
country	String	国家
province	String	省份
city	String	城市
longitude	String	经度
latitude	String	纬度
owner	String	所属机构
operator	String	运营商
zip_code	String	邮编
time_zone	String	时区
domain	String	域名
asn	String	自治系统号
as	String	自治系统名
risk_score	Integer	风险分	范围为 0 - 100
scenario	String	应用场景	枚举值： reserved：保留 IP unallocated：未分配 unrouted：已分配未路由 unused：已分配未使用 used：已使用 isp：网络运营商 idc：数据中心 ixp：交换中心 school：学校单位 satellite_comms：卫星通信 enterprise：企业专线 organization：组织机构 home_broadband：家庭宽带 mobile_network：移动网络 wlan：WLAN 热点 infra：基础设施 dedicated：专用出口 anycast：Anycast cdn：CDN

API 状态码

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

响应示例#

JSON

{
  "code": 200,
  "message": "",
  "sequence_id": "1648777165770866F82AC7F326307055",
  "continent": "Asian",
  "country_id": "CN",
  "country": "China",
  "province": "Zhejiang",
  "city": "Hangzhou",
  "longitude": "120.288024",
  "latitude": "30.174930"

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

响应唯一码

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

continent

String

大洲

country_id

String

国家编码

country

String

国家

province

String

省份

city

String

城市

longitude

String

经度

latitude

String

纬度

owner

String

所属机构

operator

String

运营商

zip_code

String

邮编

time_zone

String

时区

domain

String

域名

asn

String

自治系统号

String

自治系统名

risk_score

Integer

风险分

范围为 0 - 100

scenario

String

应用场景

枚举值：
reserved：保留 IP
unallocated：未分配
unrouted：已分配未路由
unused：已分配未使用
used：已使用
isp：网络运营商
idc：数据中心
ixp：交换中心
school：学校单位
satellite_comms：卫星通信
enterprise：企业专线
organization：组织机构
home_broadband：家庭宽带
mobile_network：移动网络 wlan：WLAN 热点 infra：基础设施 dedicated：专用出口 anycast：Anycast cdn：CDN

code

含义

200

成功

301

未购买此服务

302

流量已被禁用

303

流量不足

304

服务已过期

305

日流量已封顶

9600

系统错误

9601

IP 格式非法

9606

参数非法

{ "code": 200, "message": "", "sequence_id": "1648777165770866F82AC7F326307055", "continent": "Asian", "country_id": "CN", "country": "China", "province": "Zhejiang", "city": "Hangzhou", "longitude": "120.288024", "latitude": "30.174930"