退信地址

由特定原因(如地址不存在等)被退信的邮件会进入此列表。

列表中的地址将不再接收电子邮件通信。您可以查询弹回列表中的这些电子邮件地址。

查询

URL

https://email.api.engagelab.cc/v1/bounces

          https://email.api.engagelab.cc/v1/bounces

此代码块在浮窗中显示

HTTP 请求方法

GET

GET

此代码块在浮窗中显示

Header

Header	类型	是否必需	描述
Authorization	string	是	Basic base64(api_user:api_key)

查询参数描述

参数	类型	是否必需	描述
email	string	是	电子邮件地址，例如：`22@gmail.com`

请求示例:

curl -X GET -H 'Content-Type: application/json; charset=utf-8' -H 'Authorization: YXBpX3VzZXI6YXBpX2tleQ==' 'https://email.api.engagelab.cc/v1/bounces?email=1@2.com'

          curl -X GET -H 'Content-Type: application/json; charset=utf-8' 
     -H 'Authorization: YXBpX3VzZXI6YXBpX2tleQ==' 
     'https://email.api.engagelab.cc/v1/bounces?email=1@2.com'

此代码块在浮窗中显示

返回值描述

参数	描述
email	电子邮件地址
reason	退信原因
bounce_time	退信时间
expire_time	过期时间

返回值示例:

{ "result": [ { "email": "xjmfc@example.com", "reason": "Mailbox not found.http://service.mail.qq.com/cgi-bin/help?subtype=1&&id=20022&&no=1000728", "bounce_time": "2016-02-01T14:53:20+0800", "expire_time": "2021-07-09T00:59:37+0800" } ], "count": 1, "total": 1 }

          {
  "result": [
    {
      "email": "xjmfc@example.com",
      "reason": "Mailbox not found.http://service.mail.qq.com/cgi-bin/help?subtype=1&&id=20022&&no=1000728",
      "bounce_time": "2016-02-01T14:53:20+0800",
      "expire_time": "2021-07-09T00:59:37+0800"
    }
  ],
  "count": 1,
  "total": 1
}

此代码块在浮窗中显示