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

请求示例

{
    "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
authenticity_score	Integer	真人概率	范围 0 - 100
network_risk_labels	Array	网络风险	proxy：代理标签 idc：机房标签 vpn：VPN 标签 dynamic：秒拨标签 tor：Tor 标签 scan：端口扫描标签 brute_force：暴力破解标签
risk_labels	Array	行为风险	tampered_device：篡改设备 IP fake_device：虚假设备 IP high_risk_device：高危设备 IP

API 状态码

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",
  "owner": "China Mobile",
  "operator": "China Mobile",
  "zip_code": "310000",
  "time_zone": "UTC+8",
  "domain": "xxx.com",
  "asn": "4538",
  "as": "CNIX",
  "risk_score": 85,
  "scenario": "idc",
  "authenticity_score": 30,
  "network_risk_labels": ["idc", "proxy"],
  "risk_labels": ["fake_device"]
}