La API
La API permite que tus propias herramientas hagan lo que normalmente harías en el panel: leer elecciones, responder a un visitante que pregunta qué aceptó y publicar un sitio. Está disponible a partir de diez sitios de pago.
Claves
Un propietario o un administrador crea las claves en Ajustes, Claves de API. Una clave empieza por cmk_ y pertenece a una organización. Solo la mostramos una vez y guardamos únicamente una huella, así que cópiala enseguida. Ahí también puedes revocar una clave; las herramientas que la usan dejan de funcionar al instante.
Envía la clave con cada petición:
curl https://cookiemark.com/api/v1/sites \
-H "Authorization: Bearer cmk_..."Una clave puede hacer 120 peticiones por minuto. Si te pasas, recibes el estado 429; espera un minuto y continúa.
Listar tus sitios
GET /api/v1/sites devuelve todos los sitios de la organización con su ID, dominio, clave del script, estado y versión publicada.
Leer el registro de consentimientos
GET /api/v1/sites/{id}/consents devuelve elecciones, de la más reciente a la más antigua. Admite estos parámetros:
| Parámetro | Qué hace |
|---|---|
since, until | Solo las elecciones de este periodo, en formato de fecha ISO, como 2026-10-01. |
limit | Cuántas elecciones, hasta 1.000. El valor predeterminado es 100. |
before | Para la página siguiente: el valor de next_before de la respuesta anterior, tal como llegó. Está vacío en la última página. |
Cada elección incluye el ID de consentimiento, la acción, las tres categorías, el país, el idioma, la página, la versión del banner y la hora. Las direcciones IP acortadas y los datos del navegador se quedan en el panel.
Buscar un ID de consentimiento
GET /api/v1/consents/{consent_id} devuelve todas las elecciones hechas con un mismo ID de consentimiento, en cualquier sitio de la organización. Úsalo cuando un visitante te indique el ID de su ventana de preferencias y pregunte qué aceptó.
Ver el último análisis
GET /api/v1/sites/{id}/scan devuelve los hallazgos, las comprobaciones, las cookies y los ID de seguimiento (como los ID de Tag Manager y de la etiqueta de Google) del último análisis terminado.
Publicar un sitio
POST /api/v1/sites/{id}/publish publica el borrador actual, igual que el botón Publicar. Puedes enviar una nota, que aparece en la lista de versiones del sitio:
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"}'La respuesta incluye el número de la nueva versión.
Errores
Todos los errores llegan como JSON con un campo error en inglés sencillo.
- 400: una fecha, un cursor o un ID de consentimiento no tiene el formato correcto.
- 401: falta la clave, es incorrecta o está revocada.
- 403: la organización no tiene la API; está disponible a partir de diez sitios de pago.
- 404: el sitio no está en esta organización.
- 409: el sitio no se puede publicar, porque está archivado o porque todos los sitios de pago ya están publicados.
- 429: más de 120 peticiones en un minuto.
- 500: algo ha fallado por nuestra parte; vuelve a intentarlo dentro de un minuto.