International IP Basic

API Format#

Base URL#

Singapore: <https://sg.apitd.net/verification/persona/ip/basic/v1>
America: <https://us.apitd.net/verification/persona/ip/basic/v1>
Germany: <https://de.apitd.net/verification/persona/ip/basic/v1>

API#

URL	Request Methods	Content-Type	Output Format	Character Set
api-base-url?partner_code=xxx&partner_key=xxx	POST	application/json	JSON	UTF-8

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

Authentication

Parameter	Type	Description	Required/Optional	Notes
partner_code	String	Partner Code	required	assigned by TD
partner_key	String	Partner Key	required	assigned by TD

Request#

Parameter	Type	Description	Required/Optional	Notes
ip	String	Public IP Address	required	IPV4 and IPV6 supported

Request Example#

JSON

{
  "ip": "210.20.10.33"
}

Response Parameter#

Parameter	Type	Description	Notes
code	Integer	API Status Code
message	String	Status Message	specific abnormal reasons will be provided if the API is abnormal
sequence_id	String	Unique ID of Response	A unique ID used to mark each request
continent	String	Continent
country_id	String	Country ID
country	String	Country
province	String	Province
city	String	City
longitude	String	Longitude
latitude	String	Latitude
owner	String	Owner
operator	String	Operator
zip_code	String	Zip Code
time_zone	String	Time Zone
domain	String	Domain
asn	String	AS Number
as	String	AS Name

API Status Code

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

Response Example#

JSON

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