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