Errores y límites

Todos los errores tienen la misma forma: un code que se puede comparar y un message en español que dice qué hacer. En un 400, field dice qué campo está mal. Cada respuesta lleva X-Request-Id: dánoslo si necesitas soporte.

1HTTP/1.1 429 Too Many Requests2Retry-After: 123X-Request-Id: 2f1c9a4e-0000-4000-8000-00000000000045{ "error": { "code": "rate_limited", "message": "Más de 120 peticiones por minuto con esta llave. Espera y vuelve a intentarlo." } }

1. 1120 peticiones por minuto por llave. Al pasarse, 429 con Retry-After en segundos.
2. 2El cuerpo de un POST, hasta 64 KB; el de una llamada, hasta 2 MB con su transcripción. Al pasarse, 413.
3. 3«No hay» es 200 con la lista vacía; «no se pudo» es 503 con Retry-After. Nunca al revés.
4. 4Lo que la llave no alcanza responde 404, exista o no: la API no dice qué hay fuera de su empresa.

La lista de códigos de cada operación, con su significado, está en la referencia.