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, y 600 entre todas las llaves de una organización. Al pasarse, 429 con Retry-After en segundos.
2. 2Más de 50 peticiones por segundo desde una misma IP las corta el borde con un 429 que no lleva este formato: espera un segundo y reintenta.
3. 3El cuerpo de un POST, hasta 64 KB; el de una llamada, hasta 2 MB con su transcripción. Al pasarse, 413.
4. 4«No hay» es 200 con la lista vacía; «no se pudo» es 503 con Retry-After. Nunca al revés.
5. 5Lo que la llave no alcanza responde 404, exista o no: la API no dice qué hay fuera de su empresa.
6. 6Sin el permiso de API de la operación, 403 forbidden: error.permission dice cuál falta, y lo da un administrador en Configuración › Conectores.
7. 7Desde una IP que la llave no permite, 403 ip_not_allowed: la añade un administrador en Configuración › Conectores.
8. 8Una llave revocada, caducada, desactivada por no usarse en 90 días o mal copiada responde 401, igual que una que no existe.

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