Cuotas y límites de tasa

La API FreeMaint impone una cuota diaria por empresa, que se restablece a la medianoche UTC. El límite depende de su nivel; Los contadores y el resto se exponen como encabezados de respuesta.

Límites diarios

• Core, Starter — 0 (una clave de API requiere Business)
• Business — 5.000 llamadas/día (GraphQL y el endpoint de ingesta de energía comparten el mismo contador)
• Enterprise — 100.000 llamadas/día
• On-Premise — ilimitado (límite = null)

Encabezados de respuesta

• X-RateLimit-Limit: límite diario de su nivel
• X-RateLimit-Remaining: llamadas restantes hoy (disminuciones en cada llamada contada por cuota)
• X-RateLimit-Reset: marca de tiempo Unix de medianoche UTC (próximo reinicio)

lo que no cuenta

Solo /public-api/whoami es gratuito: no descuenta de tu contador, así que puedes verificar una clave y su plan sin gastar cuota. Todo lo que pasa por /api/v1/graphql se contabiliza, incluida la consulta whoami, y también el endpoint de ingesta de energía.

Qué cuenta como una llamada

El contador se incrementa por OPERACIÓN, no por petición HTTP. Agrupar 50 mutaciones con alias en una sola petición consume igualmente 50 unidades. Agrupar ahorra viajes de red, nunca cuota. Para que una sincronización periódica salga barata, traiga solo lo que cambió con parts(updatedSince: "...") en lugar de releer todo el catálogo.

Cuando excedes el límite

Una vez alcanzado el límite diario, cada llamada adicional se rechaza con el mensaje «Daily API cap reached». En las superficies REST (/public-api/ping, el endpoint de ingesta de energía) es un HTTP 403. En GraphQL el estado HTTP es 200 y el rechazo está en errors[0].extensions.code = FORBIDDEN, con originalError.statusCode = 403. El contador se reinicia a las 00:00 UTC. No hay límite flexible, ni margen de ráfaga, ni ventana por minuto: la ventana es el día.