国际 IP 风险画像基础版

API 方式#

Base URL#

新加坡节点：https://sg.apitd.net/verification/persona/ip/basic/v1
美国节点：https://us.apitd.net/verification/persona/ip/basic/v1
德国节点：https://de.apitd.net/verification/persona/ip/basic/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/basic/v1?partner_code=test_code∂ner_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	自治系统名

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"