Notifications techniques

Pour contribuer à maintenir la stabilité du système et améliorer les performances, Adobe Acrobat Sign introduit un seuil d’interrogation pour les points d’entrée de l’API GET. Cette politique limite la fréquence à laquelle les applications client peuvent effectuer des appels d’API identiques vers le service Acrobat Sign.

L’interrogation à haute fréquence crée une charge inutile sur les systèmes back-end, qui peuvent dégrader les performances dégradées et allonger les temps de réponse. Les développeurs API sont encouragés à utiliser les webhooks pour les mises à jour en temps quasi réel au lieu d’interrogations répétées.

Nouveautés

La politique d’interrogation s’applique à tous les points d’entrée d’API GET pour les appels identiques.

Une limite est appliquée à la fréquence à laquelle le même utilisateur effectif peut faire le même appel API auprès d’Acrobat Sign. Une erreur est renvoyée lorsque le même utilisateur effectif effectue des appels identiques plus fréquemment que ne le permet le seuil d’interrogation applicable.

Par exemple, une demande répétée au même point d’entrée pour le même accord ou document de bibliothèque est traitée comme un appel identique. Les demandes pour différents accords ou documents de bibliothèque sont traitées comme des appels distincts car chaque objet représente une cible de demande différente.

Exemples de points d’entrée affectés

Récupération du statut

• GET /agreements/{agreementId} : récupère le statut actuel d’un accord.
• GET /agreements/{agreementId}/documents/{documentId} : récupère le flux de fichier d’un document au sein d’un accord.

Listing, événements et documents de bibliothèque

• GET /agreements : récupère les accords pour l’utilisateur.
• GET /agreements/{agreementId}/events : récupère les informations relatives aux événements d’un accord.
• GET /libraryDocuments — Récupère les documents de la bibliothèque de l’utilisateur.
• GET /libraryDocuments/{libraryDocumentId} — Récupère les informations d’un document de bibliothèque spécifique.

Détails de la politique d’interrogation

L’Intervalle minimum d’interrogation d’objet (MOPI) définit la fréquence à laquelle le même utilisateur effectif peut effectuer la même requête GET d’API vers le service Acrobat Sign.

L’intervalle minimum d’interrogation d’objet par défaut varie selon le niveau de service :

• Niveaux GLOBAL, ENTERPRISE et DEVELOPER : Trois appels identiques par intervalle d’une minute.
• Tous les autres niveaux : trois appels identiques par intervalle de trois minutes.

Si le même utilisateur effectif effectue des requêtes GET identiques plus fréquemment que ne le permet le niveau, Acrobat Sign renvoie une réponse 429 Too Many Requests avec un en-tête Retry-After.

Une requête est considérée comme identique lorsque le même utilisateur effectif effectue la même requête GET avec le même chemin de requête et les mêmes en-têtes dans l’intervalle d’interrogation applicable.

Gestion des ETag

Les applications peuvent continuer à utiliser les ETag et l’en-tête If-None-Match pour les points d’entrée qui prennent en charge les requêtes GET conditionnelles.

Pour les requêtes GET conditionnelles autorisées conformément au seuil d’interrogation, Acrobat Sign peut renvoyer 304 Not Modified lorsque la ressource n’a pas changé.

Lorsque le seuil d’interrogation est dépassé, Acrobat Sign renvoie 429 Too Many Requests avec un en-tête Retry-After, même lorsque la requête inclut un en-tête If-None-Match.

Action requise

Si votre application nécessite des mises à jour en temps quasi réel, utilisez des webhooks et non des interrogations. Les webhooks offrent un moyen plus efficace et évolutif de recevoir des mises à jour en temps opportun.

Si les webhooks ne peuvent pas être utilisés, les applications doivent utiliser une mise en cache côté client pour stocker et réutiliser les réponses API.

• Lorsqu’une réponse 304 Not Modified est reçue, utilisez les données en cache au lieu de faire un autre appel API.
• Lorsqu’une réponse 429 Too Many Requests est reçue, relancez l’appel API uniquement après le nombre de secondes fourni dans l’en-tête Retry-After.

Ressources

• Gestion des réponses 429 : https://developer.adobe.com/acrobat-sign/docs/overview/developer_guide/apiusage#handling-rate-limiting-http-429
• Seuil d’interrogation des API : https://developer.adobe.com/acrobat-sign/docs/overview/developer_guide/apiusage#get-endpoints

Chronologie

Les seuils MOPI mis à jour sont déjà en production.

• Le comportement de limitation des ETag mis à jour est inclus dans la version 17.1.1. Après cette modification, Acrobat Sign renvoie 429 Too Many Requests pour les requêtes soumises à limitation y compris les requêtes GET conditionnelles incluant un en-tête If-None-Match.
• La politique d’interrogation est définie sur ENFORCED pour les nouveaux comptes dans l’environnement Sandbox le 11 février 2026.
• La politique d’interrogation est définie sur ENFORCED pour les nouveaux comptes dans l’environnement de production le 5 avril 2026.

Veuillez contacter votre CSM si vous avez besoin d’aide ou si vous avez des questions.