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 superó el límite y conviene esperar en vez de reintentar de inmediato.
Pasos
- En 401, compruebe que la clave existe, no ha vencido y se envía en el encabezado que cree: lo habitual es un pegado truncado.
- En 403, lea 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, lea el campo que nombra la respuesta y corrija la carga.
- En 429, respete los encabezados de límite y espere. Reintentar al instante lo empeora.
- Guarde el
requestIdde la respuesta: es lo que permite a soporte encontrar su 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ó su problema?
Esto no ayudó
Escríbanos indicando plataforma y versión, los pasos que siguió, el resultado esperado y el espacio de trabajo o código QR involucrado. Enmascare cualquier secreto antes de adjuntar algo.
Escribir a soporte