Limites de débit

Fonctionnement des limitesCopier le lien

Nudge limite les requêtes par adresse IP sur les endpoints publics, par rendez-vous sur les endpoints qui agissent sur un rendez-vous, et par utilisateur sur le serveur MCP. Plusieurs limites peuvent s'appliquer au même appel ; la première atteinte l'emporte.

• Les limites utilisent des fenêtres fixes : le compteur repart à zéro au début de chaque fenêtre (chaque minute, chaque tranche de cinq minutes…), pas de façon glissante.
• Les limites sont partagées entre tous les serveurs de Nudge.
• En cas de dépassement, Nudge répond 429 Too Many Requests avec un en-tête Retry-After en secondes. C'est une borne haute sûre : attendre cette durée fonctionne toujours.

Limites par endpointCopier le lien

API de réservation IACopier le lien

Gestion d'un rendez-vousCopier le lien

Serveur MCPCopier le lien

Sur le serveur MCP, chaque requête JSON-RPC compte, y compris tools/list. Si la limite ne peut pas être vérifiée, la requête est refusée plutôt que laissée passer.

Endpoints publics des formulairesCopier le lien

GET /api/public/{orgSlug}/{formSlug} et /hosts n'ont pas de limite par IP publiée. Appelez-les quand vous avez besoin de données fraîches, pas en boucle : gardez le résultat en cache quelques minutes de votre côté.

Gérer un 429Copier le lien

{ "error": { "code": "rate_limited", "message": "Rate limited" } }

{ "error": "rate_limited" }

{ "error": "Rate limit exceeded" }

Bonnes pratiques :

1. Lisez Retry-After et attendez au moins ce nombre de secondes avant de réessayer.
2. Ne réessayez pas en boucle serrée : chaque appel refusé compte quand même dans la fenêtre en cours.
3. Pour book, envoyez un en-tête Idempotency-Key afin qu'une nouvelle tentative après un délai dépassé ne réserve jamais deux fois (voir Réserver un rendez-vous).
4. Mettez en cache ce qui change peu : le manifeste et la définition du formulaire ne changent que lorsque vous modifiez le formulaire.
5. Pour les disponibilités, demandez la plage voulue avec date_from et date_to plutôt qu'un appel par jour.

Construire un agent pour de nombreux visiteursCopier le lien

Les limites sont par IP. Si votre agent tourne sur un serveur et réserve pour de nombreuses personnes, tous ses appels partagent l'IP de ce serveur et ses 5 réservations par minute. Étalez les réservations dans le temps, mettez-les en file, et gardez chaque appel léger (un get_availability pour une semaine, puis un book).