Limites de débit, quotas et pagination

Quotas fonctionnels¶

Certains modules imposent des quotas métier, distincts d'un simple débit HTTP :

Module	Quota	Où le lire
Cloud	Stockage (5 / 50 / 200 Go selon palier)	GET /api/cloud/quota
IA	Requêtes + tokens par mois et par organisation	GET /api/ai/usage?month=YYYY-MM

Au-delà, l'action est refusée (upload bloqué, inférence refusée) jusqu'à libération d'espace, mois suivant, ou montée de palier. Voir Pricing → Quotas.

Limitation de débit d'envoi (Send)¶

Les e-mails sont mis en file puis envoyés avec une limitation de débit par organisation et globale (fenêtre glissante, backoff). Un délai est donc normal ; ce n'est pas une erreur. Suivez le statut d'un envoi par son id.

Gating (rappel)¶

Le premier « quota » est l'abonnement : un module non inclus renvoie 403. Voir Gating par module.

Pagination & filtres¶

Les endpoints de liste acceptent des filtres en query string, propres à chaque module :

• Work : projectId, status sur /api/work/items ;
• Knowledge : status, collectionId, tag sur les articles ;
• IA : month sur l'usage ;
• Careers : filtres sur les candidatures/offres.

Reportez-vous à la référence de chaque module pour les paramètres exacts. Quand une liste est volumineuse, filtrez côté requête plutôt que de tout rapatrier.

Concurrence¶

Certaines ressources utilisent une concurrence optimiste (jeton xmin PostgreSQL, ex. la numérotation des items Work). Un conflit remonte en 409 : relisez la ressource et réessayez.

Conseils¶

• Mettez en cache les données stables (catalogue de pricing, liste de projets) plutôt que de les redemander en boucle.
• Respectez les délais de la file d'envoi et du pipeline IA : ces systèmes sont asynchrones par conception.