API Format
Base URL
- Singapore: https://sg.apitd.net/verification/persona/email/basic/v1
- America: https://us.apitd.net/verification/persona/email/basic/v1
- Germany: https://de.apitd.net/verification/persona/email/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/email/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 |
|---|---|---|---|---|
| String | Email Address | required |
Request Example
{
"email": "[email protected]"
}
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 |
| status | String | Email Status | enumeration: valid invalid abuse unknown |
| risk_labels | Array | Risk Label | suspicious temporary random similar |
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 |
| 9606 | Illegal parameter |
Response Example
{
"code": 200,
"message": "",
"sequence_id": "1648777165770866F82AC7F326307055",
"status": "invalid",
"risk_labels": ["suspicious"]
}