退信地址

最新更新:2023-08-10

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

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

查询

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:Basic 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:Basic 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
}

        
此代码块在浮窗中显示
在文档中心打开
icon
联系销售