Skip to main content
La API v1 devuelve los errores como JSON dentro de la propiedad error:
code es el valor que debes procesar en tu aplicación. message contiene una descripción breve. Algunos errores también incluyen details y correlation_id.

​
Códigos de estado

Usa el estado HTTP junto con error.code: La referencia de cada endpoint muestra los códigos de error exactos que puede devolver.

​
Identificadores de correlación

Cada respuesta de la API v1 incluye X-Correlation-ID. El cuerpo de un error también puede incluir el mismo valor en error.correlation_id. Cuando investigues una solicitud fallida, registra el identificador de correlación junto con el estado y error.code. No registres la credencial Bearer ni campos de respuesta que puedan contener datos personales.

​
Decisiones de reintento

  • Para 429, espera el número de segundos indicado en Retry-After antes de reintentar.
  • Para 503, no trates la respuesta como si restableciera una cuota. Una interrupción del limitador usa rate_limiter_unavailable y no incluye Retry-After.
  • Para 401 o 403, corrige la credencial, el permiso o el acceso a la cuenta en lugar de repetir la misma solicitud.
  • Para 422, corrige la solicitud con ayuda de la referencia del endpoint.
Consulta Límites de solicitudes para conocer el comportamiento completo de 429.