Quotas et limites de débit

L'API FreeMaint applique un quota quotidien par entreprise, réinitialisé à minuit UTC. Le plafond dépend de votre niveau ; les compteurs et le reste sont exposés en tant qu’en-têtes de réponse.

Caps quotidiens

• Core, Starter — 0 (une clé d'API exige Business)
• Business — 5 000 appels/jour (GraphQL et le point d'ingestion énergie partagent le même compteur)
• Enterprise — 100 000 appels/jour
• On-Premise — illimité (plafond = null)

En-têtes de réponse

• X-RateLimit-Limit — le plafond quotidien de votre niveau
• X-RateLimit-Remaining – appels restants aujourd'hui (diminutions à chaque appel comptabilisé par quota)
• X-RateLimit-Reset — Horodatage Unix de minuit UTC (prochaine réinitialisation)

Ce qui ne compte pas

Seul /public-api/whoami est gratuit : il ne décrémente pas votre compteur, ce qui permet de vérifier une clé et son palier sans consommer de quota. Tout ce qui passe par /api/v1/graphql est décompté, y compris la requête whoami, de même que le point d'ingestion énergie.

Ce qui compte pour un appel

Le compteur s'incrémente par OPÉRATION, pas par requête HTTP. Grouper 50 mutations aliasées dans un seul appel consomme quand même 50 unités. Le regroupement économise donc des allers-retours, jamais du quota. Pour qu'une synchronisation récurrente reste abordable, ne récupérez que ce qui a changé avec parts(updatedSince: "...") au lieu de relire tout le catalogue.

Lorsque vous dépassez le plafond

Une fois le plafond quotidien atteint, tout appel supplémentaire est refusé avec le message « Daily API cap reached ». Sur les surfaces REST (/public-api/ping, le point d'ingestion énergie), c'est un HTTP 403. Sur GraphQL, le statut HTTP est 200 et le refus se trouve dans errors[0].extensions.code = FORBIDDEN, avec originalError.statusCode = 403. Le compteur repart à 00:00 UTC. Il n'y a ni plafond souple, ni tolérance de rafale, ni fenêtre par minute : la fenêtre, c'est la journée.