Saltar al contenido principal
Una llamada que falla responde un estado HTTP de 400 o más y un cuerpo de tipo application/problem+json, la forma estándar de RFC 9457:

Decide por el código

La página de cada operación en la referencia de la API lista los códigos que puede responder, como la de Iniciar una exportación. Lee code, y params cuando el código los tiene:

Una petición con campos mal

422 core.validation_failed lista en errors cada parte de la petición que rechazó:
  • location es la parte de la petición: body, querystring, params (la ruta) o headers.
  • pointer es un JSON Pointer al campo, # para la parte entera.
  • code dice qué tiene mal, y params sus límites, como minimum o maximum. El valor que enviaste nunca vuelve.

Los códigos comunes

Estos códigos vienen de lo que recorre cada llamada, o de un tipo de llamada que comparten muchas operaciones; la página de cada operación lista los que puede responder:
Un 4xx que no sea 429 responde lo mismo hasta que cambies la petición o la llave: no lo repitas sin cambios. Un 429 o un 503 dice cuánto esperar en Retry-After: espera ese tiempo, nunca en un bucle sin pausa. Para repetir una escritura sin hacerla dos veces, envía un Idempotency-Key.