退信地址
由特定原因(如地址不存在等)被退信的郵件會進入此列表。
列表中的地址將不再接收電子郵件通信。您可以查詢彈回列表中的這些電子郵件地址。
調用地址
| 數據中心 | URL |
|---|---|
| 新加坡 | https://email.api.engagelab.cc |
| 土耳其 | https://emailapi-tr.engagelab.com |
當使用REST API時，需要確認使用的數據中心選擇對應的base URL。
POST/v1/bounces
查詢
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) |
查詢參數描述
| 參數 | 類型 | 是否必需 | 描述 |
|---|---|---|---|
| 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'
此代碼塊在浮窗中顯示
返回值描述
| 參數 | 描述 |
|---|---|
| 電子郵件地址 | |
| 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
}
此代碼塊在浮窗中顯示
