Bounces

E-Mails, die beispielsweise wegen nicht existierender E-Mail-Adressen zurückgesendet werden, werden auf die Bounce-Liste gesetzt. Die Adressen auf dieser Liste erhalten keine weiteren E-Mails. Sie können die E-Mail-Adressen auf der Bounce-Liste abfragen.

Aufrufadresse

Rechenzentrum	URL
Singapur	https://email.api.engagelab.cc
Türkei	https://emailapi-tr.engagelab.com

Beim Einsatz der REST API ist darauf zu achten, dass das gewählte Rechenzentrum zur entsprechenden Basis-URL passt.

POST/v1/bounces

Abfrage

URL

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

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

Diesen Codeblock im schwebenden Fenster anzeigen

HTTP-Anfragemethode

GET

GET

Diesen Codeblock im schwebenden Fenster anzeigen

Header

Header	Typ	Erforderlich	Beschreibung
Authorization	String	ja	Basic base64(api_user:api_key)

Beschreibung der Query-Parameter

Parameter	Typ	Erforderlich	Beschreibung
email	string	ja	E-Mail-Adresse, z. B. `22@gmail.com`

Beispiel für eine Anfrage:

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'

Diesen Codeblock im schwebenden Fenster anzeigen

Beschreibung der Rückgabewerte

Parameter	Beschreibung
email	E-Mail-Adresse
reason	Grund für den Bounce
bounce_time	Zeitstempel, wann der Bounce aufgetreten ist
expire_time	Ablaufzeitpunkt für die Bounce-Interzeption

Beispiel für Rückgabewerte:

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

Diesen Codeblock im schwebenden Fenster anzeigen

Bounces API

Aufrufadresse

Abfrage