Skip to main content

​
Cupos por organización

Los límites de tasa se aplican por organización, no por llave. Cada llave emitida para la misma organización comparte un cupo, así que agregar llaves no multiplica tu cuota. El límite por defecto es de 100 solicitudes por día por organización. Algunos endpoints tienen un tope por hora adicional sobre ese cupo, y la consulta de jobs usa un cupo propio: Los topes por hora son adicionales, no independientes: una llamada a Research consume uno de sus 10 espacios por hora y una de tus 100 solicitudes diarias. La página de cada endpoint indica su límite. Las solicitudes en lote cuentan como una solicitud por elemento: un lote de 10 elementos consume 10 de tu cuota, igual que 10 llamadas individuales.

​
Cuota en los encabezados de respuesta

El estado del límite de tasa viene como encabezados HTTP en cada respuesta (no en el cuerpo):

​
Reintentos e idempotencia

Toda operación de Croma es una consulta: repetir una solicitud con el mismo cuerpo devuelve el mismo resultado y nunca crea ni modifica un registro, así que reintentar tras un timeout o una conexión caída siempre es seguro. Envía un encabezado opcional Idempotency-Key (cualquier cadena de hasta 255 caracteres; un UUID sirve) y la API lo devuelve en el encabezado de respuesta Idempotency-Key, para que puedas ligar un reintento con su primer intento en tus logs. Cada intento que llega a la API cuenta contra la cuota de arriba; un 429 te pide esperar Retry-After segundos en lugar de reintentar de inmediato. | X-Request-Id | Id único de la solicitud (req_…); inclúyelo en los reportes de soporte. | | X-Cache | HIT o MISS en endpoints cacheables. Los aciertos de caché igual cuentan contra tu cuota. |

​
Cuando excedes el límite

Las solicitudes que superan la cuota devuelven 429 con un sobre rate_limit_error y un encabezado Retry-After (segundos):
Espera (back off) hasta que transcurra Retry-After (o X-RateLimit-Reset), luego reintenta.
El limitador falla abierto: si el backend de límite de tasa no está disponible por un momento, las solicitudes se dejan pasar y no se emiten encabezados X-RateLimit-*. No dependas de que los encabezados estén siempre presentes.

Siguiente: Errores

El sobre de error y cada código de error.