API Reference
中文

International IP Basic

API Format

Base URL

API

URLRequest MethodsContent-TypeOutput FormatCharacter Set
api-base-url?partner_code=xxx&partner_key=xxxPOSTapplication/jsonJSONUTF-8

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

Authentication
ParameterTypeDescriptionRequired/OptionalNotes
partner_codeStringPartner Coderequiredassigned by TD
partner_keyStringPartner Keyrequiredassigned by TD

Request

ParameterTypeDescriptionRequired/OptionalNotes
ipStringPublic IP AddressrequiredIPV4 and IPV6 supported

Request Example

{
    "ip": "210.20.10.33"
}

Response Parameter

ParameterTypeDescriptionNotes
codeIntegerAPI Status Code
messageStringStatus Messagespecific abnormal reasons will be provided if the API is abnormal
sequence_idStringUnique ID of ResponseA unique ID used to mark each request
continentStringContinent
country_idStringCountry ID
countryStringCountry
provinceStringProvince
cityStringCity
longitudeStringLongitude
latitudeStringLatitude
ownerStringOwner
operatorStringOperator
zip_codeStringZip Code
time_zoneStringTime Zone
domainStringDomain
asnStringAS Number
asStringAS Name

API Status Code

codeDescription
200Success
301Service not purchased
302Traffic blocked
303Traffic insufficient
304Service expired
305Daily maximum volume reached
9600System error
9601Illegal ip
9606Illegal parameter

Response Example

{
  "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"
}