Kunden API
Informationen zu Ihrer Kunden API finden Sie im Admin Dashboard unter dem Menüpunkt Kunden-API. Mit Hilfe der Kunden API können Sie folgende Aktionen durchführen.
- Kunden erstellen
- Kundendaten auslesen
- Kundendaten bearbeiten / aktualisieren
- Kunde löschen
Natürlich können alle diese Aktionen nur durchgeführt werden wenn eine entsprechende Autorisierung vorliegt.
Verbindung zur API herstellen
Um eine API-Anfrage erfolgreich zu verarbeiten, hängen Sie den API-Schlüssel an jede Anfrage an, indem Sie den GET-Parameter apiKey
hinzufügen und den Schlüssel als Wert festlegen.
Setzen Sie für jede POST- und PUT-Anfrage den HTTP-Header Content-Type
auf application/json
; d.h. für jede Anfrage, die einen Nachrichtenkörper enthält. Kodieren Sie den zu sendenden Payload entsprechend.
Die echten API Schlüssel sind natürlich wesentlich komplexer ;-)
Halten Sie Ihren API-Schlüssel immer geheim. Wenn der Schlüssel kompromittiert ist, können Sie ihn hier ändern; danach müssen Sie all Ihre Apps aktualisieren.
Hawk HTTP-Authentifizierung verwenden
Wenn Sie diese Option aktivieren, kann eine signierte Anfrage verifiziert werden. Die Clientseite für diese Authentifizierungsmethode müssen sie jedoch selbst implementieren und in Ihre Anwendungen integrieren.
Verwenden Sie das Shared Secret, um Ihre Anfragen zu signieren. Dazu müssen Sie mithilfe des PBKDF2
-Algorithmus einen Schlüssel aus dem Shared Secret ableiten.
Hawk HTTP-Authentifizierung verwenden
Wenn Sie diese Option aktivieren, kann eine signierte Anfrage verifiziert werden. Die Clientseite für diese Authentifizierungsmethode müssen sie jedoch selbst implementieren und in Ihre Anwendungen integrieren.
Verwenden Sie das Shared Secret, um Ihre Anfragen zu signieren. Dazu müssen Sie mithilfe des PBKDF2
-Algorithmus einen Schlüssel aus dem Shared Secret ableiten.
Diese Funktion ist optional. Verwenden Sie diese Option, um eine teilweise kryptografische Verifizierung Ihrer Anfragen zu ermöglichen.
Sehen Sie sich folgende Ressourcen an, um Ihre Anfragen korrekt zu signieren.
API Endpunkte
Es gibt insgesamt 4 verschieden API Endpunkte die Sie nutzen können, im einzelnen sind das:
Kunden erstellen
URL http://localhost/ccm19/cookie-consent-management/www/public/hosting/api/client
Methode POST
Nachrichtenkörper
username
: stringpassword
: string – Das Passwort des Kunden in KlartextpasswordHash
: string – [optional] Ein vorberechneter Passwort-Hash (bcrypt: $2y$);password
hat Vorrangactive
: bool – [optional] (Standardwert: false) Gibt an, ob sich der Kunde einloggen kann.firstName
: string – [optional]lastName
: string – [optional]emailAddress
: stringcompany
: string – [optional]domainMaxCount
: int – [optional] (Standardwert: 0) Maximale Anzahl an Domains, die ein Kunde in seinem Account verwalten kann; -1 ist unbegrenztwhitelabelMaxCount
: int – [optional] (Standardwert: 0) Maximale Anzahl an Whitelabel-Lizenzen, die einem Kunden zur Verfügung stehen; -1 ist unbegrenztwidgetDisplayMaxCount
: int – [optional] (Standardwert: 0) Legt fest, wie häufig das CCM19-Widget im Frontend pro Monat geladen wird; -1 ist unbegrenzt
Antwort (HTTP Status-Codes)
- 201– Kunde wurde erfolgreich erstellt.
id
: stringusername
: stringactive
: boolfirstName
: stringlastName
: stringemailAddress
: stringcompany
: stringdomainMaxCount
: intwhitelabelMaxCount
: int-
widgetDisplayMaxCount
: int -
400
– Benutzername oder Passwort ist leer. 400
– Benutzername wird bereits verwendet.400
– E-Mail-Adresse ist leer oder ungültig.
Kunden auslesen
URL http://localhost/ccm19/cookie-consent-management/www/public/hosting/api/client/~CLIENT_ID~
Methode GET
Query-Parameter
~CLIENT_ID~
: string Die ID des CCM19-Kundenaccounts.
Antwort (HTTP Status-Codes)
- 200 – Success!
id
: stringusername
: stringactive
: boolfirstName
: stringlastName
: stringemailAddress
: stringcompany
: stringdomainCount
: intdomainMaxCount
: intwhitelabelCount
: intwhitelabelMaxCount
: intwidgetDisplayCount
: intwidgetDisplayMaxCount
: int404
– Kunden nicht gefunden.
Kunden aktualisieren
URL http://localhost/ccm19/cookie-consent-management/www/public/hosting/api/client/~CLIENT_ID~
Methode PUT
Query-Parameter
~CLIENT_ID~
: string Die ID des CCM19-Kundenaccounts.
Nachrichtenkörper
password
: string – [optional] Das Passwort des Kunden in KlartextpasswordHash
: string – [optional] Ein vorberechneter Passwort-Hash (bcrypt: $2y$);password
hat Vorrangactive
: bool – [optional] Gibt an, ob sich der Kunde einloggen kann.firstName
: string – [optional]lastName
: string – [optional]emailAddress
: string – [optional]company
: string – [optional]domainMaxCount
: int – [optional] Maximale Anzahl an Domains, die ein Kunde in seinem Account verwalten kann; -1 ist unbegrenztwhitelabelMaxCount
: int – [optional] Maximale Anzahl an Whitelabel-Lizenzen, die einem Kunden zur Verfügung stehen; -1 ist unbegrenztwidgetDisplayMaxCount
: int – [optional] Legt fest, wie häufig das CCM19-Widget im Frontend pro Monat geladen wird; -1 ist unbegrenzt
Antwort (HTTP Status-Codes)
- 200 – Kunde wurde erfolgreich aktualisiert.
id
: stringusername
: stringactive
: boolfirstName
: stringlastName
: stringemailAddress
: stringcompany
: stringdomainMaxCount
: intwhitelabelMaxCount
: intwidgetDisplayMaxCount
: int400
– E-Mail-Adresse ist leer oder ungültig.404
– Kunden nicht gefunden.
Kunden löschen
URL http://localhost/ccm19/cookie-consent-management/www/public/hosting/api/client/~CLIENT_ID~
Methode DELETE
Query-Parameter
~CLIENT_ID~
: string Die ID des CCM19-Kundenaccounts.
Antwort (HTTP Status-Codes)
204
– Kunde wurde erfolgreich gelöscht.404
– Kunden nicht gefunden.