Resolución de problemas
Errores frecuentes, qué significan y cómo resolverlos.
Una clave publicable devuelve 403 "no Origin allowlist"
Las claves pk_ deben estar restringidas por Origin. Añade dominios permitidos a la clave, o verifica al menos un dominio en el sitio (Sites & API keys → + domain).
POST /v1/consent devuelve 422 "purpose has no published version"
Crea el propósito, añade al menos un idioma de texto en su borrador y publica esa versión. El consentimiento solo se registra contra versiones publicadas.
La misma Idempotency-Key devuelve 409
Has reutilizado la clave con un cuerpo distinto. Un reintento debe enviar un JSON idéntico byte a byte. Las claves tienen alcance por (sitio, entorno).
Una lectura de sujeto ha creado un sujeto en blanco
Los endpoints de lectura devuelven 404 con identificadores desconocidos; solo las escrituras crean sujetos. Si una lectura ha creado uno, estabas usando una ruta de escritura: revisa el método.
Tras un borrado, el sujeto sigue en la bóveda
Es intencionado: el crypto-shredding destruye el material de cifrado de los identificadores (el sujeto queda imposible de localizar), pero el registro de eventos anonimizado se conserva por defendibilidad legal.
Las entregas de webhook fallan
Revisa el registro de entregas del endpoint. Los fallos se reintentan con backoff exponencial hasta 8 intentos; puedes reenviar cualquier entrega desde la consola. Comprueba que tu endpoint responde 2xx en menos de 10 s.
Sospecho que se ha filtrado una clave de API
Revócala en Sites & API keys y revisa el Audit log de la organización y la cronología de la bóveda en busca de escrituras atribuidas a ese apiKeyId. Crea una clave de reemplazo (o rótala: la nueva es válida y la anterior sigue funcionando hasta que la revoques).