退信地址

最新更新: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: 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
}

        
此代碼塊在浮窗中顯示
在文档中心打开