Limites de débit

Les routes limitées

Les routes anonymes, qui s'appellent sans jeton, sont limitées par adresse IP : au plus quelques dizaines d'appels par minute selon la route. C'est le cas de la lecture groupée des statuts de parcours (POST https://staging-api.docage.com/Transactions/Statuses, cent identifiants au plus par appel, trente appels par minute). Au-delà, elles répondent 429 : attendez une minute avant de réessayer.

Les appels authentifiés ne sont pas limités en nombre. Ils sont soumis à deux règles de bon usage :

• Un jeton par session de travail. Chaque jeton demandé ouvre une connexion ; deux connexions de l'API utilisées dans la même minute par le même utilisateur font une connexion simultanée, facturée à l'heure (voir S'authentifier). Gardez votre jeton, prolongez-le avant son échéance plutôt que d'en demander un nouveau.
• Ce qui consomme des crédits — un parcours lancé, un SMS, un horodatage… — est compté à l'organisation selon ses conditions.

Appeler sans gaspiller

• Paginez : une liste sans Take rend tout ce que l'utilisateur voit (voir Lire des listes).
• Ne lisez que l'utile : EntityProperties, ou EntitiesIdAndName pour un sélecteur.
• Ne guettez pas : plutôt que de relire une fiche toutes les minutes pour voir si elle a changé, abonnez-vous à ses webhooks.
• Groupez les gestes qui ont une route de lot : BatchDelete, BatchRestore, Duplicate prennent une liste d'identifiants.

Réessayer

Après un 429, un 502, un 503, ou une coupure du réseau, réessayez avec une attente croissante (1 s, 2 s, 4 s…). Avant de rejouer une création, lisez Rejouer une requête sans doublon : une création qui a répondu en erreur a pu être enregistrée.