API Reference
English

国际 IP 风险画像基础版

API 方式

Base URL

API

URL请求方式Content-Type输出格式字符集
api-base-url?partner_code=xxx&partner_key=xxxPOSTapplication/jsonJSONUTF-8

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

认证参数
字段类型含义建议备注
partner_codeString合作方标识必须由 TD 分配
partner_keyString合作方密钥必须由 TD 分配

请求参数

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

请求示例

{
    "ip": "210.20.10.33"
}

响应参数

字段类型含义备注
codeIntegerAPI 状态码
messageString状态信息在 API 异常状态下会输出具体的异常原因
sequence_idString响应唯一码用于跟踪每次请求记录的唯一标识
continentString大洲
country_idString国家编码
countryString国家
provinceString省份
cityString城市
longitudeString经度
latitudeString纬度
ownerString所属机构
operatorString运营商
zip_codeString邮编
time_zoneString时区
domainString域名
asnString自治系统号
asString自治系统名

API 状态码

code含义
200成功
301未购买此服务
302流量已被禁用
303流量不足
304服务已过期
305日流量已封顶
9600系统错误
9601IP 格式非法
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-ap"
}