Limites de débit
Deux familles de limites - ce que le plan autorise et à quelle vitesse on peut appeler un endpoint - avec les chiffres servis par l'API qui les applique.
cmssy applique deux types de limites, et elles répondent à des questions différentes. Un quota de plan dit combien de produit votre organisation a acheté : pages, stockage, requêtes delivery par mois. Un garde-fou dit à quelle vitesse n'importe qui peut appeler un endpoint, quel que soit le plan. Une requête peut tenir largement dans votre quota et être quand même refusée par un garde-fou, et c'est lui qui répond 429.
Ce que signifie un 429
Chaque garde-fou refuse de la même façon : HTTP 429 avec un en-tête Retry-After qui porte le nombre de secondes avant la réouverture de la fenêtre. Attendez ce délai, puis réessayez.
La fenêtre est fixe, ce n'est pas un seau qui se vide pendant que vous frappez. Un client qui traite 429 comme un 500 et réessaie aussitôt reste refusé jusqu'à la fin de la fenêtre, et y brûle sa propre capacité. Lisez l'en-tête.
Le delivery est budgété par espace
L'API delivery est celle que vous appelez depuis votre propre serveur : son budget est donc par espace de travail, pas par appelant. Chaque visiteur de votre site est rendu depuis une poignée de vos IP régionales, et un crawler qui réchauffe un cache froid épuiserait un budget par appelant en quelques secondes. La seconde ligne delivery est ce filet anti-abus plus large, compté par adresse - l'adresse qui nous atteint, quel que soit le jeton - et non le budget sur lequel tourne votre site.
Un site rendu sur son propre serveur peut nous dire pour quel visiteur est une requête : envoyez l'adresse du visiteur dans x-cmssy-client-ip avec un jeton API limité à l'espace de travail dans x-cmssy-api-token, et chaque budget par adresse - delivery, panier, connexion des membres, envois de formulaires - est compté par visiteur et non par serveur. La paire n'est honorée que si le jeton appartient à cet espace de travail et que son propriétaire y a toujours accès ; gardez-le côté serveur, jamais dans un navigateur. Le jeton est vérifié une fois par minute et par serveur, et cette vérification coûte à votre serveur un slot de son propre budget delivery. Tant que la paire est honorée, Retry-After et les en-têtes X-RateLimit-* décrivent le seau du visiteur, et X-RateLimit-Scope nomme la portée qui a répondu : workspace ou caller.
Chaque lecture compte, mise en cache ou non. Un CDN devant votre site est précisément ce qui vous maintient dans le budget, parce qu'il coupe les lectures qui nous parviennent - mais une lecture qui nous parvient est comptée, que vous mettiez la réponse en cache ou non.
La profondeur n'est pas un débit
Deux garde-fous se mesurent en niveaux, pas en requêtes : une requête imbriquée plus profondément que la limite est rejetée immédiatement, et attendre n'y change rien. Aplatissez la requête.
Les quotas mensuels sont mutualisés
Les quotas de plan appartiennent à l'organisation, pas à un espace de travail. Les requêtes delivery et la bande passante sont mutualisées sur tous les espaces de l'organisation, et comptées sur le mois calendaire.
Lire les tableaux
Les deux tableaux ci-dessous sont servis par l'API qui applique ces chiffres : cette page ne peut donc pas diverger du produit. Les lignes marquées comme ajustables sont celles qu'un opérateur peut déplacer pour un déploiement ; tout autre chiffre est le même pour tout le monde.