Bounces API

Última actualización：2023-08-10

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

Este bloque de código se muestra en una ventana flotante

HTTP Request Method

GET

GET

Este bloque de código se muestra en una ventana flotante

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'

Este bloque de código se muestra en una ventana flotante

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
}

Este bloque de código se muestra en una ventana flotante