Bounces API

Emails that are returned due to certain specific reasons, such as non-existent email addresses, will be added to the bounce list. The addresses on the list will no longer receive email communications. You can query these email addresses in the bounce list.

Query

URL

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

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

このコードブロックは、フローティングウィンドウに表示されます

HTTP Request Method

GET

GET

このコードブロックは、フローティングウィンドウに表示されます

Header

Header	Type	Required	Description
Authorization	String	true	Basic base64(api_user:api_key)

Query Parameter Description

Parameter	Type	Required or not	Description
email	string	yes	Email address, e.g, `22@gmail.com`

Request Example:

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'

このコードブロックは、フローティングウィンドウに表示されます

Returned Value Description

Parameter	Description
email	Email address
reason	Bounce reason
bounce_time	Timestamp of when the bounce occurred
expire_time	Expiration time for bounce interception

Returned Value Example:

{ "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
}

このコードブロックは、フローティングウィンドウに表示されます