发件人和发件方域名 API

概述

在 EffiLink 中注册、验证与移除已验证的发件人地址。检查 MX、SPF、DKIM 与 DMARC 验证的 DNS 记录状态。

获取发件人

POST /v5/verified_senders/get 返回与您账户关联的所有已验证发件人及其 DNS 验证状态。可选择过滤到单个发件人地址。

请求体

string

过滤到特定发件人地址的结果。省略此字段(或传入空对象)以获取所有发件人。

响应

int

成功时为 200。

string

成功时为空字符串;失败时为错误描述。

array[object]

已验证发件人记录数组。

显示 sender 对象

string

发件人邮箱地址(例如 noreply@yourdomain.com)。

string

发件人邮箱域名(例如 yourdomain.com)。

int

MX 记录验证状态。1 = 有效,0 = 无效或未验证。

int

SPF 记录验证状态。1 = 有效,0 = 无效或未验证。

int

DKIM 记录验证状态。1 = 有效,0 = 无效或未验证。

int

DMARC 记录验证状态。1 = 有效,0 = 无效或未验证。

int

总体验证标志。1 = 完全验证,0 = 待验证或失败。

int

1 表示该域名是 EffiLink 托管的域名;0 表示自定义域名。

int

1 = 营销发件人;2 = 事务性发件人。

curl --request POST \
  --url https://api.effilink.co/v5/verified_senders/get \
  --header 'Content-Type: application/json' \
  --header 'ApiKey: YOUR_API_KEY' \
  --data '{}'

Response

{
  "code": 200,
  "message": "",
  "mailFromDomains": [
    {
      "from": "noreply@yourdomain.com",
      "fromDomain": "yourdomain.com",
      "mxStatus": 1,
      "spfStatus": 1,
      "dkimStatus": 1,
      "dmarcStatus": 1,
      "isValidate": 1,
      "isYiyeDomain": 0,
      "senderType": 2
    }
  ]
}

添加发件人

POST /v5/verified_senders/add 注册新的发件人邮箱地址以进行域名验证。地址必须属于子域名或非顶级域名(例如 noreply@mail.yourdomain.com)。

请求体

string

必填

要注册的发件人邮箱地址。必须是非顶级域名地址(例如 noreply@yourdomain.com)。

string

必填

此发件人的预期用途:

"1" — 营销邮件。
"2" — 事务性邮件。

boolean

为 true 时,操作被模拟且不注册任何发件人。

响应

int

成功时为 200。

string

成功时为空字符串;失败时为错误描述。

curl --request POST \
  --url https://api.effilink.co/v5/verified_senders/add \
  --header 'Content-Type: application/json' \
  --header 'ApiKey: YOUR_API_KEY' \
  --data '{
    "senderEmail": "noreply@yourdomain.com",
    "senderType": "2"
  }'

Response

{
  "code": 200,
  "message": ""
}

验证发件人域名

POST /v5/verified_senders/verify 触发实时 DNS 查询,以验证已注册发件人地址的 MX、SPF、DKIM 和 DMARC 记录。

请求体

string

必填

要验证其域名 DNS 记录的发件人地址。

string

必填

EffiLink 为您域名发布 DKIM 公钥时使用的 DKIM 选择器字符串(例如 effilink2024)。

响应

int

成功时为 200。

string

成功时为空字符串;失败时为错误描述。

boolean

当所有必需的 DNS 记录都通过验证时为 true。

boolean

当 MX 记录配置正确时为 true。

boolean

当 SPF 记录配置正确时为 true。

boolean

当 DKIM 记录针对给定选择器配置正确时为 true。

boolean

当 DMARC 记录配置正确时为 true。

curl --request POST \
  --url https://api.effilink.co/v5/verified_senders/verify \
  --header 'Content-Type: application/json' \
  --header 'ApiKey: YOUR_API_KEY' \
  --data '{
    "fromDomain": "noreply@yourdomain.com",
    "selector": "effilink2024"
  }'

Response

{
  "code": 200,
  "message": "",
  "valid": true,
  "goodMX": true,
  "goodSPF": true,
  "goodDKIM": true,
  "goodDMARC": true
}

删除发件人

POST /v5/verified_senders/delete 从您的账户中移除已验证的发件人地址。已在传输中的邮件不受影响。

请求体

string

必填

要移除的发件人邮箱地址。

boolean

为 true 时,操作被模拟且不删除任何发件人。

响应

int

成功时为 200。

string

成功时为空字符串;失败时为错误描述。

Response

{
  "code": 200,
  "message": ""
}

事务性邮件

营销邮件

短信

联系人与名单

Webhooks

身份验证

发件人和发件方域名 API

概述

获取发件人

请求体

响应

添加发件人

请求体

响应

验证发件人域名

请求体

响应

删除发件人

请求体

响应

​概述

​获取发件人

​请求体

​响应

​添加发件人

​请求体

​响应

​验证发件人域名

​请求体

​响应

​删除发件人

​请求体

​响应

概述

获取发件人

请求体

响应

添加发件人

请求体

响应

验证发件人域名

请求体

响应

删除发件人

请求体

响应