De API
Met de API doen je eigen tools wat je anders in het dashboard doet: keuzes lezen, een bezoeker antwoorden die wil weten waarmee hij heeft ingestemd, en een site publiceren. Je krijgt hem vanaf tien betaalde sites.
Sleutels
Een eigenaar of beheerder maakt sleutels aan onder Instellingen, API-sleutels. Een sleutel begint met cmk_ en hoort bij één organisatie. We tonen hem één keer en bewaren alleen een vingerafdruk, dus kopieer hem meteen. Daar trek je een sleutel ook in; tools die hem gebruiken, werken dan meteen niet meer.
Stuur de sleutel mee met elk verzoek:
curl https://cookiemark.com/api/v1/sites \
-H "Authorization: Bearer cmk_..."Een sleutel mag 120 verzoeken per minuut doen. Daarboven krijg je status 429; wacht een minuut en ga dan verder.
Je sites opvragen
GET /api/v1/sites geeft elke site van de organisatie terug, met ID, domein, scriptsleutel, status en live versie.
Het consentlog lezen
GET /api/v1/sites/{id}/consents geeft keuzes terug, de nieuwste eerst. Je kunt deze parameters meegeven:
| Parameter | Wat het doet |
|---|---|
since, until | Alleen keuzes in deze periode, als ISO-datums zoals 2026-10-01. |
limit | Het aantal keuzes, maximaal 1.000. Standaard 100. |
before | Voor de volgende pagina: de waarde van next_before uit het vorige antwoord, ongewijzigd. Op de laatste pagina is die leeg. |
Elke keuze bevat het consent-ID, de actie, de drie categorieën, het land, de taal, de pagina, de bannerversie en het tijdstip. Ingekorte IP-adressen en browsergegevens blijven in het dashboard.
Een consent-ID opzoeken
GET /api/v1/consents/{consent_id} geeft elke keuze terug die onder één consent-ID is gemaakt, op elke site van de organisatie. Gebruik het als een bezoeker het ID uit zijn voorkeurenvenster noemt en vraagt waarmee hij heeft ingestemd.
De laatste scan bekijken
GET /api/v1/sites/{id}/scan geeft de bevindingen, de controles, de cookies en de tracking-ID's (zoals ID's van Tag Manager en de Google-tag) van de laatste afgeronde scan terug.
Een site publiceren
POST /api/v1/sites/{id}/publish zet het huidige concept live, net als de knop Publiceren. Je kunt een notitie meesturen, die verschijnt in de lijst met versies van de site:
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"}'Het antwoord bevat het nieuwe versienummer.
Fouten
Elke fout komt als JSON met een veld error in begrijpelijk Engels.
- 400: een datum, cursor of consent-ID heeft niet de juiste vorm.
- 401: de sleutel ontbreekt, klopt niet of is ingetrokken.
- 403: de organisatie heeft geen toegang tot de API; die krijg je vanaf tien betaalde sites.
- 404: de site hoort niet bij deze organisatie.
- 409: de site kan niet worden gepubliceerd, omdat hij is gearchiveerd of alle betaalde sites al live staan.
- 429: meer dan 120 verzoeken in een minuut.
- 500: er ging aan onze kant iets mis; probeer het over een minuut opnieuw.