| 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>
| Parameter | Type | Description | Required/Optional | Notes |
|---|
| partner_code | String | Partner Code | required | assigned by TD |
| partner_key | String | Partner Key | required | assigned by TD |
| Parameter | Type | Description | Required/Optional | Notes |
|---|
| email | String | Email Address | required | |
| 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 |
| free_mail | String | Free Mail Status | enumeration: free, paid, unknown |
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 |
{
"code": 200,
"message": "",
"sequence_id": "1648777165770866F82AC7F326307055",
"status": "invalid",
"risk_labels": ["suspicious"],
"free_mail": "free"
}
