Acceso y cuotas

Sin API key

Bazar es abierto: sin API key, cada dirección IP puede hacer 5 consultas por segundo, 10 por minuto y 30 al día (el día en hora UTC). Entre todos los usuarios sin key hay además un total de 1.000 consultas al día; si se agota, el acceso sin key se cierra hasta medianoche UTC.

Cuenta cada petición a /v1 y cada llamada a herramienta en /mcp; conectarse y listar las herramientas no cuenta.

curl "https://bazar.boelabs.com/v1/stores"

Con API key

Para un uso mayor, o desde un servidor que comparte su IP, usa una API key. Tiene su propia cuota por minuto y no gasta las cuotas sin key:

curl -H "Authorization: Bearer bz_…" "https://bazar.boelabs.com/v1/stores"

Una key mal escrita, desconocida o revocada responde 401; nunca se trata como acceso anónimo.

• Pedirla: las keys las crea el equipo de Bazar, una por consumidor; pídela por el canal de soporte de Boelabs.
• Guardarla: la key se muestra una sola vez. Guárdala como un secreto, del lado del servidor, nunca en un frontend.
• La misma key sirve para REST y para MCP, y gasta una sola cuota.
• Rotarla: se crea una nueva y se revoca la vieja. Una key revocada deja de funcionar en menos de un minuto.

Cuánto queda

Cada respuesta con cuota trae RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset (segundos hasta que se renueva la ventana). Al agotarse, la respuesta es 429 RATE_LIMITED con Retry-After: espera esos segundos antes de reintentar.

/health, la referencia OpenAPI y /llms.txt son públicos y no gastan cuota.

Límites