国际邮箱风险画像专业版

API 方式

Base URL

新加坡节点：https://sg.apitd.net/verification/persona/email/pro/v1
美国节点：https://us.apitd.net/verification/persona/email/pro/v1
德国节点：https://de.apitd.net/verification/persona/email/pro/v1

API

URL	请求方式	Content-Type	输出格式	字符集
api-base-url?partner_code=xxx∂ner_key=xxx	POST	application/json	JSON	UTF-8

示例：https://sg.apitd.net/verification/persona/email/pro/v1?partner_code=test_code∂ner_key=test_key

认证参数

字段	类型	含义	建议	备注
partner_code	String	合作方标识	必须	由 TD 分配
partner_key	String	合作方密钥	必须	由 TD 分配

请求参数

字段	类型	含义	建议	备注
email	String	Email 地址	必须

请求示例

{
    "email": "[email protected]"
}

响应参数

字段	类型	含义	备注
code	Integer	API 状态码
message	String	状态信息	在 API 异常状态下会输出具体的异常原因
sequence_id	String	响应唯一码	用于跟踪每次请求记录的唯一标识
status	String	邮箱状态	枚举值： valid：有效邮箱 invalid：无效邮箱 abuse：垃圾邮箱 unknown：未知邮箱
risk_labels	Array	风险标签	suspicious：疑似风险邮箱 temporary：临时邮箱 random：随机邮箱 alias：别名邮箱 similar：相似邮箱
free_mail	String	免费邮箱状态	枚举值： free：免费邮箱 paid：付费邮箱 unknown：未知邮箱
risk_score	Integer	风险分	范围 0 - 100

API 状态码

code	含义
200	成功
301	未购买此服务
302	流量已被禁用
303	流量不足
304	服务已过期
305	日流量已封顶
9600	系统错误
9606	参数非法

响应示例

{
  "code": 200,
  "message": "",
  "sequence_id": "1648777165770866F82AC7F326307055",
  "status": "invalid",
  "risk_labels": ["suspicious"],
  "free_mail": "free",
  "risk_score": 100
}