Un cupo por organización
Los límites se aplican por organización, no por llave. Cada llave emitida para la misma organización comparte un cupo, así que agregar llaves no lo multiplica.Topes por hora
Algunos endpoints tienen un tope por hora encima del plan, y la consulta de jobs usa un cupo propio:
En el plan gratuito los topes son adicionales: una llamada a Research consume
uno de sus 10 espacios por hora y 10 créditos de tu plan. En los planes de pago
los créditos son el único límite. La página de cada endpoint indica
su límite.
Encabezados
El estado de los límites viene como encabezados HTTP en cada respuesta, no en el cuerpo:Reintentos
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. Un encabezado opcionalIdempotency-Key (cualquier cadena de hasta 255
caracteres; un UUID sirve) vuelve en la respuesta, para que puedas ligar un
reintento con su primer intento en tus logs. Cada intento que llega a la API
cuenta; un 429 te pide esperar Retry-After segundos en lugar de reintentar
de inmediato.
Cuando excedes un tope
Las solicitudes que superan un tope por hora devuelven429 con un sobre
rate_limit_error y un encabezado Retry-After (segundos):
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.