Delivery Response

Call-Adresse

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

Beim Einsatz der REST API stellen Sie bitte sicher, dass das gewählte Datenzentrum zur entsprechenden Basis-URL passt.

POST /v1/email_status

Abfrage

Liste der E-Mail-Statusmeldungen

Hier können Sie den Status Ihrer E-Mails überprüfen.

URL

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

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

Diesen Codeblock im schwebenden Fenster anzeigen

HTTP-Request-Methode

GET

GET

Diesen Codeblock im schwebenden Fenster anzeigen

Request-Header

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

Beschreibung der Query-Parameter

Parameter	Typ	erforderlich	Beschreibung
offset	string	nein	Startposition, [0-], Standardwert ist 0
limit	int	nein	Anzahl, [0-100], Standardwert ist 100
send_date	string	ja	Format des Versanddatums: `yyyy-MM-dd`
email	string	nein	Empfängeradresse
email_ids	string	nein	Mehrere Adressen werden durch Semikolon getrennt, z. B. `email_ids=a;b;c`; die emailId wird nach erfolgreichem Versand über die API zurückgegeben
api_user	string	nein	api_user-Name
domain_name	string	nein	Empfangende Domain, z. B.: gmail.com
label_id	string	nein	Label-ID des erstellten Labels
status	string	nein	Status. Sende-Status-Wert ist 18, zugestellt ist 1, Soft Bounce ist 5, ungültige E-Mail ist 4.
sub_status	string	nein	Mehrere sub_status, getrennt durch Semikolon, z. B. `sub_status=a;b;c`. Wird dieser Parameter übergeben, ist der Status-Parameter ungültig.

Hinweise:

Standardmäßig werden pro Suche 100 Datensätze angezeigt. Bei mehr als 100 Datensätzen bitte limit und offset angeben.

Jeder Abfrage-Datensatz wird für 10 Minuten zwischengespeichert.

Dieses Interface beschränkt jedes Benutzerkonto auf 60 Aufrufe pro Minute. Wenn Sie mehr benötigen, verwenden Sie bitte den WebHook.

Wird der email-Parameter übergeben, können die Zustellungsdetails der entsprechenden Adresse innerhalb von 30 Tagen nach dem send_date abgefragt werden. Ohne email-Parameter sind nur die Daten des send_date abrufbar.

sub_status	sub_status Beschreibung
401	Ungültige E-Mail – Blacklist
402	Ungültige E-Mail – Abmeldung
403	Ungültige E-Mail – Serverfehler
404	Ungültige E-Mail – Formatfehler
405	Ungültige E-Mail – IP-Ablehnung
406	Ungültige E-Mail – Nicht existent
407	Ungültige E-Mail – Junk-Mail
408	Ungültige E-Mail – Abgelehnt
409	Ungültige E-Mail – Sonstige
503	Soft Bounce – Serverfehler
505	Soft Bounce – IP-Ablehnung
506	Soft Bounce – Nicht existent
507	Soft Bounce – Spam abgelehnt
508	Soft Bounce – Abgelehnt
509	Soft Bounce – Sonstige

Beispiel für eine Anfrage / Beispiel einer Anfrage:

curl "https://email.api.engagelab.cc/v1/email_status?send_date=2022-11-21&email_ids=***;***" --header "Authorization: Basic <<YOUR_API_KEY_HERE>>"

              
              curl "https://email.api.engagelab.cc/v1/email_status?send_date=2022-11-21&email_ids=***;***" --header "Authorization: Basic <<YOUR_API_KEY_HERE>>"

Diesen Codeblock im schwebenden Fenster anzeigen

Beschreibung der Rückgabewerte

Feld	Beschreibung
email	Empfängeradresse
email_id	emailId, die nach erfolgreichem Versand über die API zurückgegeben wird
api_user	api_user-Name
status	E-Mail-Status
status_desc	Statusbeschreibung
sub_status	401-509 ungültiger Statuscode
sub_status_desc	Beschreibung der ungültigen oder Soft Bounce-Unterkategorie
request_time	Anfragezeitpunkt
update_time	Aktualisierungszeitpunkt
response_message	Antwort

Beispiel für einen Rückgabewert

{ "result": [ { "email_id": "1668065941982_15_2032_7460.sc-10_2_226_96-test0$1720f4a1d6af047181@hotmail.com", "api_user": "zymtest4", "email": "1720f4a1d6af047181@hotmail.com", "request_time": "2022-11-10T15:39:01+0800", "update_time": "2022-11-10T17:34:16+0800", "status": 4, "sub_status": 409, "status_desc": "Ungültige E-Mail", "sub_status_desc": "Sonstige", "response_message": "Other(scheduler: deleted)" } ], "total": "48675", "count": 1 }

              
              {
    "result": [
        {
            "email_id": "1668065941982_15_2032_7460.sc-10_2_226_96-test0$1720f4a1d6af047181@hotmail.com",
            "api_user": "zymtest4",
            "email": "1720f4a1d6af047181@hotmail.com",
            "request_time": "2022-11-10T15:39:01+0800",
            "update_time": "2022-11-10T17:34:16+0800",
            "status": 4,
            "sub_status": 409,
            "status_desc": "Ungültige E-Mail",
            "sub_status_desc": "Sonstige",
            "response_message": "Other(scheduler: deleted)"
        }
    ],
    "total": "48675",
    "count": 1
}

Diesen Codeblock im schwebenden Fenster anzeigen

Zustellungs-Response

Call-Adresse

Abfrage