API pública
Diagnosticar 401, 403, 422 y 429
401 significa que la clave no se aceptó en absoluto. 403 significa que se aceptó pero la operación no está permitida. 422 significa que la petición se entendió y la carga era incorrecta. 429 significa que superas el límite y conviene esperar en vez de reintentar de inmediato.
Pasos
- En 401, comprueba que la clave existe, no ha caducado y se envía en la cabecera que crees: lo habitual es un pegado truncado.
- En 403, lee el
code: scope insuficiente, una dirección fuera de la lista permitida o una clave de otro espacio. Reconectar no ayuda; hay que cambiar el permiso. - En 422, lee el campo que nombra la respuesta y corrige la carga.
- En 429, respeta las cabeceras de límite y espera. Reintentar al instante lo empeora.
- Guarda el
requestIdde la respuesta: es lo que permite a soporte encontrar tu llamada exacta.
Cómo comprobar el resultado
La misma petición funciona tras la corrección, y la respuesta trae un estado 2xx con el objeto esperado.
Lo que suele salir mal
- Tratar un 403 como clave mala y reemitirla, lo que no cambia nada.
- Reintentar un 429 en un bucle cerrado.
- Mandar la clave a soporte en lugar del identificador de la petición.
¿Esto resolvió tu problema?
Esto no ayudó
Escríbenos indicando plataforma y versión, los pasos que seguiste, el resultado esperado y el espacio de trabajo o código QR implicado. Enmascara cualquier secreto antes de adjuntar nada.
Escribir a soporte