API Format
Base URL
- Singapore: https://sg.apitd.net/verification/persona/ip/pro/v1
- America: https://us.apitd.net/verification/persona/ip/pro/v1
- Germany: https://de.apitd.net/verification/persona/ip/pro/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/pro/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
{
"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 | |
risk_score | Integer | Risk Score | range: 0 - 100 |
scenario | String | Scenario | enumeration: reserved unallocated unrouted unused used isp idc ixp school satellite_comms enterprise organization home_broadband mobile_network wlan infra dedicated anycast cdn |
authenticity_score | Integer | Authenticity Score | range: 0 - 100 |
network_risk_labels | Array | Network Risk | proxy idc vpn dynamic tor scan brute_force |
risk_labels | Array | Behavioral Risk | tampered_device fake_device high_risk_device |
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
{
"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",
"risk_score": 85,
"scenario": "idc",
"authenticity_score": 30,
"network_risk_labels": ["idc", "proxy"],
"risk_labels": ["fake_device"]
}