Die API
Mit der API erledigen Ihre eigenen Tools, was Sie sonst im Dashboard tun würden: Einwilligungen lesen, einem Besucher antworten, der wissen möchte, wozu er zugestimmt hat, und eine Website veröffentlichen. Sie ist ab zehn bezahlten Websites enthalten.
Schlüssel
Ein Inhaber oder Administrator legt Schlüssel unter Einstellungen, API-Schlüssel an. Ein Schlüssel beginnt mit cmk_ und gehört zu einer Organisation. Wir zeigen ihn nur einmal und speichern nur einen Fingerabdruck, kopieren Sie ihn also sofort. Dort widerrufen Sie einen Schlüssel auch; Tools, die ihn verwenden, funktionieren dann sofort nicht mehr.
Senden Sie den Schlüssel mit jeder Anfrage:
curl https://cookiemark.com/api/v1/sites \
-H "Authorization: Bearer cmk_..."Ein Schlüssel darf 120 Anfragen pro Minute stellen. Darüber erhalten Sie den Status 429; warten Sie eine Minute und machen Sie dann weiter.
Ihre Websites auflisten
GET /api/v1/sites gibt jede Website der Organisation zurück, mit ID, Domain, Skript-Schlüssel, Status und Live-Version.
Das Einwilligungsprotokoll lesen
GET /api/v1/sites/{id}/consents gibt die Auswahlen der Besucher zurück, die neuesten zuerst. Diese Parameter sind möglich:
| Parameter | Beschreibung |
|---|---|
since, until | Nur Auswahlen in diesem Zeitraum, als ISO-Datum wie 2026-10-01. |
limit | Anzahl der Einträge, höchstens 1.000. Standard ist 100. |
before | Für die nächste Seite: der Wert von next_before aus der vorherigen Antwort, unverändert. Auf der letzten Seite ist er leer. |
Jede Auswahl enthält Einwilligungs-ID, Aktion, die drei Kategorien, Land, Sprache, Seite, Banner-Version und Zeitpunkt. Gekürzte IP-Adressen und Browserangaben bleiben im Dashboard.
Eine Einwilligungs-ID nachschlagen
GET /api/v1/consents/{consent_id} gibt jede Auswahl zurück, die unter einer Einwilligungs-ID getroffen wurde, auf jeder Website der Organisation. Nutzen Sie den Endpunkt, wenn ein Besucher die ID aus seinem Präferenzen-Fenster nennt und wissen möchte, wozu er zugestimmt hat.
Den letzten Scan ansehen
GET /api/v1/sites/{id}/scan gibt die Befunde, die Prüfungen, die Cookies und die Tracking-IDs (etwa Tag-Manager- und Google-Tag-IDs) des letzten abgeschlossenen Scans zurück.
Eine Website veröffentlichen
POST /api/v1/sites/{id}/publish schaltet den aktuellen Entwurf live, genau wie die Schaltfläche Veröffentlichen. Sie können eine Notiz mitsenden, die in der Versionsliste der Website erscheint:
curl -X POST https://cookiemark.com/api/v1/sites/{id}/publish \
-H "Authorization: Bearer cmk_..." \
-H "Content-Type: application/json" \
-d '{"note": "New cookie list after the October scan"}'Die Antwort enthält die neue Versionsnummer.
Fehler
Jeder Fehler wird als JSON zurückgegeben, mit einem Feld error in verständlichem Englisch.
- 400: Ein Datum, ein Cursor oder eine Einwilligungs-ID hat nicht das richtige Format.
- 401: Der Schlüssel fehlt, ist falsch oder wurde widerrufen.
- 403: Die Organisation hat keinen Zugang zur API; sie ist ab zehn bezahlten Websites enthalten.
- 404: Die Website gehört nicht zu dieser Organisation.
- 409: Die Website kann nicht veröffentlicht werden, weil sie archiviert ist oder bereits alle bezahlten Websites live sind.
- 429: Mehr als 120 Anfragen in einer Minute.
- 500: Bei uns ist etwas schiefgelaufen; versuchen Sie es in einer Minute erneut.