REST eMarketingManager
Über die REST-Schnittstelle fügen Sie neue Einträge zur Sperrliste des eMarketingManagers hinzu oder aktualisieren bestehende E-Mail-Adressen.
Wenn eine E-Mail-Adresse vom Kunden geändert wurde, wird auch im eMM diese Mail-Adresse auf die Sperrliste gesetzt, sofern die alte Mail-Adresse auf der Sperrliste vorhanden ist.
Inhaltsverzeichnis
- 1 API eMarketingManager
- 1.1 Eintrag zur Sperrliste hinzufügen (emm/addlock)
- 1.1.1 Request
- 1.1.2 Content-Type
- 1.1.3 Authorization-Token
- 1.1.4 Request-Body
- 1.1.5 Beispiel Request-Body
- 1.1.6 Beispiel cURL
- 1.1.7 Response
- 1.2 Eintrag in der Sperrliste updaten (emm/changeemail)
- 1.2.1 Request
- 1.2.2 Content-Type
- 1.2.3 Authorization-Token
- 1.2.4 Request-Body
- 1.2.5 Beispiel Request-Body
- 1.2.6 Beispiel cURL
- 1.2.7 Response
- 1.1 Eintrag zur Sperrliste hinzufügen (emm/addlock)
API eMarketingManager
Eintrag zur Sperrliste hinzufügen (emm/addlock)
Adressen können zur Sperrliste hinzugefügt werden. Dabei müssen die E-Mail-Adresse und der Grund angegeben werden.
Request
POST https://www.websale.de/api/emm/addlock
Content-Type
application/json
Authorization-Token
benötigt
Request-Body
Eigenschaft | Typ | Beschreibung |
---|---|---|
string | E-Mail-Adresse, die zur Sperrliste hinzugefügt werden soll | |
reason | string | Begründungstext, warum die Adresse zur Liste hinzugefügt werden soll |
Beispiel Request-Body
In diesem Beispiel wird die Adresse "beispiel@websale.de" zur Liste hinzugefügt, da der Adressinhaber dies telefonisch veranlasst hat.
{
"email": "beispiel@websale.de",
"reason": "telefonisch veranlasst"
}
Beispiel cURL
Die Adresse "beispiel@websale.de" wird zur Liste hinzugefügt, da der Adressinhaber dies telefonisch veranlasst hat.
curl \
-X POST \
-H "Content-Type: application/json" \
-H "X-Authorization: Bearer eyJhbGciOiJIUzI1Ni...jBhOWMyMmRmNzFkOT==" \
-d '{
"email": "beispiel@websale.de",
"reason": "telefonisch veranlasst"
}' \
"https://www.websale.de/api/emm/addlock"
Response
Bei Erfolg wird HTTP-Code 200 zurückgegeben. Der Content ist leer.
Ist ein Fehler aufgetreten, wird ein 400er Code zurückgegeben.
Eintrag in der Sperrliste updaten (emm/changeemail)
Wenn jemand z. B. die E-Mail-Adresse wechselt, muss die Sperrliste (sofern die alte Adresse in der Sperrliste steht) um die neue Adresse erweitert werden.
Request
Content-Type
application/json
Authorization-Token
benötigt
Request-Body
Eigenschaft | Typ | Beschreibung |
---|---|---|
oldadress | string | Alte E-Mail-Adresse, nach der in der Sperrliste gesucht werden soll |
newaddress | string | Neue E-Mail-Adresse, die in die Sperrliste eingetragen werden soll, wenn die oldaddress in der Liste gefunden wurde |
Beispiel Request-Body
Der User hat die E-Mail-Adresse von "beispiel@websale.de" in "neueadresse@websale.de" geändert. Diese soll mit in die Sperrliste eingetragen werden, sofern die alte Adresse auch in der Liste steht.
Beispiel cURL
Der User hat die E-Mail-Adresse von "beispiel@websale.de" in "neueadresse@websale.de" geändert. Diese soll mit in die Sperrliste eingetragen werden, sofern die alte Adresse auch in der Liste steht.
Response
Bei Erfolg wird HTTP-Code 200 zurückgegeben. Der Content ist leer.
Ist ein Fehler aufgetreten, wird ein 400er Code zurückgegeben.