Keine Interceptions: E-Mail-Adressen gezielt von der Filterung ausnehmen
Engagelab fängt E-Mail-Adressen bei Beschwerden, Blockierungen, Bounces und Abmeldungen ab. Wenn Sie nicht möchten, dass eine bestimmte E-Mail-Adresse oder Empfangsdomäne abgefangen wird, können Sie diese zur no_interception-Liste (Ausschlussliste/Whitelist) hinzufügen. So stellen Sie sicher, dass wichtige Adressen weiterhin erreicht werden.
Diese Liste kann abgefragt, hinzugefügt und gelöscht werden.
Aufrufadresse
| Datenzentrum | URL |
|---|---|
| Singapur | https://email.api.engagelab.cc |
| Türkei | https://emailapi-tr.engagelab.com |
Stellen Sie bei der Nutzung der REST API sicher, dass das ausgewählte Datenzentrum zur entsprechenden Basis-URL passt.
Endpunkt: POST /v1/no_interceptions
Abfragen
URL
https://email.api.engagelab.cc/v1/no_interceptions
HTTP-Methode
GET
Header
| Header | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| Authorization | string | Ja | Basic base64(api_user:api_key) |
Beschreibung der Query-Parameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| start_date | string | Ja | Startdatum, Format: yyyy-MM-dd |
| end_date | string | Ja | Enddatum, Format: yyyy-MM-dd |
| email_or_domain | string | Ja | E-Mail-Adresse oder Empfangsdomäne (z. B. 11@gmail.com, hotmail.com) |
| api_user | string | Nein | unintercept API_USER, Standardwert: all |
| offset | int | Nein | Anzahl, Bereich: 0-100, Standardwert: 100 |
| limit | int | Nein | Anzahl, Bereich: 0-100, Standardwert: 100 |
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/no_interceptions'
Beschreibung der Rückgabewerte
| Parameter | Beschreibung |
|---|---|
| api_user | unintercept API_USER |
| email_or_domain | unintercept Empfangsdomäne oder E-Mail-Adresse |
| create_time | Erstellungszeit |
Beispiel für Rückgabewerte
{
"result": [
{
"api_user": "all",
"email_or_domain": "wbw@hotmail.com",
"create_time": "2021-07-15 15:32:03"
}
],
"count": 1,
"total": 1
}
Hinzufügen
URL
https://email.api.engagelab.cc/v1/no_interceptions
HTTP-Methode
POST
Header
| Header | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| Authorization | string | Ja | Basic base64(api_user:api_key) |
Beschreibung der Body-Parameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| api_user | string | Nein | unintercept API_USER, Standardwert: all |
| email_or_domain | array | Ja | unintercept Empfangsdomäne oder E-Mail-Adresse |
Beispiel für eine Anfrage:
curl -X POST -H 'Content-Type: application/json; charset=utf-8' \
-H 'Authorization:Basic YXBpX3VzZXI6YXBpX2tleQ==' \
--data '{"api_user": "123456abc", "email_or_domain": ["qq.com","22@gmail.com"]}' \
'https://email.api.engagelab.cc/v1/no_interceptions'
Beschreibung der Rückgabewerte
| Parameter | Beschreibung |
|---|---|
| api_user | unintercept API_USER |
| email_or_domain | unintercept Empfangsdomäne oder E-Mail-Adresse |
| create_time | Erstellungszeit |
Beispiel für Rückgabewerte
{
"result": [{
"api_user": "all",
"email_or_domain": "qq.com",
"create_time": "2021-07-19 11:30:00"
},{
"api_user": "all",
"email_or_domain": "22@gmail.com",
"create_time": "2021-07-19 11:30:00"
}
]
}
Löschen
URL
https://email.api.engagelab.cc/v1/no_interceptions
HTTP-Methode
DELETE
Header
| Header | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| Authorization | string | Ja | Basic base64(api_user:api_key) |
Beschreibung der Body-Parameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| api_user | string | Nein | unintercept API_USER |
| email_or_domain | array | Ja | unintercept Empfangsdomänen oder E-Mail-Adressen |
Beispiel für eine Anfrage:
curl -X DELETE -H 'Content-Type: application/json; charset=utf-8' \
-H 'Authorization:Basic YXBpX3VzZXI6YXBpX2tleQ==' \
--data '{"api_user": "123456abc", "email_or_domain": ["qq.com","22@gmail.com"]}' \
'https://email.api.engagelab.cc/v1/no_interceptions'
Beschreibung der Rückgabewerte
| Parameter | Beschreibung |
|---|---|
| count | Anzahl erfolgreich gelöschter Einträge |
Beispiel für Rückgabewerte
{
"count": 1
}
Hinweis: Die API-Endpunkte für das Hinzufügen und Löschen von No Interceptions sind identisch. Achten Sie darauf, die passenden HTTP-Methoden (POST für Hinzufügen, DELETE für Löschen) zu verwenden.
Weitere Informationen
Nutzen Sie die No Interceptions-Funktion, um wichtige E-Mail-Adressen oder Domains gezielt von der automatischen Filterung auszuschließen. So behalten Sie die volle Kontrolle über Ihre E-Mail-Kommunikation und steigern die Zustellrate geschäftskritischer Nachrichten.
Jetzt testen:
- Abfragen
- Hinzufügen
- Löschen
Mehr erfahren: Engagelab E-Mail-API Dokumentation
