Die Schnittstelle /blacklist/ ermöglicht die Verwaltung einer Blacklist für E-Mail-Adressen, die vom Versand von Newslettern ausgeschlossen werden sollen.

Über entsprechende Endpunkte können neue Einträge hinzugefügt oder bestehende gelöscht werden.

Inhaltsverzeichnis:

1 1. Unterstützte Methoden
2 2. Verwendung der Methoden
- 2.1 2.1 POST blacklist/add
3 3. Support

1. Unterstützte Methoden

Angabe aller unterstützten Methoden.

Befehl/Info	Endpunkte	GET	POST	PUT	DELETE

Befehl/Info	Endpunkte	GET	POST	PUT	DELETE
Blacklist verwalten	blacklist/

2. Verwendung der Methoden

2.1 POST blacklist/add

Dieser Endpunkt fügt eine E-Mail-Adresse zur Blacklist hinzu.

Die Adresse wird im Request-Body übermittelt und bei erfolgreicher Verarbeitung als Hash gespeichert. Die Antwort gibt an, ob die Operation erfolgreich war (true) oder fehlgeschlagen ist (false).

Der Zugriff auf diesen Endpunkt erfordert ein Benutzerkonto mit entsprechenden Berechtigungen.

Beispiel:

https://www.<ihr-shop>.de/admin/api/v1/blacklist/add

Request Body:

{
    "email": "example@example.com"
}

Antwort:

true/false

Fehlercodes:

Fehler	Typ	Grund

Fehler	Typ	Grund
401 Unauthorized		Nicht autorisiert: Sie sind nicht angemeldet oder verfügen nicht über die erforderlichen Rechte zum Schreiben von Blacklist-Daten.
400 Bad Request		Request body konnte nicht geladen werden.
400 Bad Request	"missing"	`email` wurde nicht übergeben.
400 Bad Request	"invalidFormat"	`email` ist kein String.

3. Support

Bei technischen Fragen und Hilfestellungen ist unser Support-Team für Sie erreichbar: Zum Kundenportal

Bitte senden Sie uns eine möglichst detaillierte Beschreibung sowie Screenshots, Requests/Antworten damit wir Ihre Anfrage zeitnah und zielführend beantworten können.

API-Referenz Blacklist