Notifiche tecniche

Per mantenere la stabilità del sistema e migliorare le prestazioni, Adobe Acrobat Sign sta introducendo una soglia di polling per gli endpoint delle API GET. Questo criterio limita la frequenza con cui le applicazioni client possono effettuare chiamate API identiche al servizio Acrobat Sign.

Il polling ad alta frequenza crea un carico non necessario sui sistemi di back-end, che può causare una riduzione delle prestazioni e tempi di risposta più lenti. Gli sviluppatori API sono invitati a utilizzare i webhook per aggiornamenti quasi in tempo reale invece del polling ripetuto.

Che cosa cambia

Questo criterio di polling viene applicato a tutti gli endpoint API GET per chiamate identiche.

Viene applicato un limite alla frequenza con cui lo stesso utente effettivo può eseguire la stessa chiamata API ad Acrobat Sign. Quando lo stesso utente effettivo effettua chiamate identiche più frequentemente rispetto a quanto consentito dalla soglia di polling applicabile, viene restituito un errore.

Ad esempio, una richiesta ripetuta allo stesso endpoint per lo stesso accordo o documento di libreria viene considerata come una chiamata identica. Le richieste per accordi o documenti di libreria diversi vengono considerate come chiamate distinte perché ogni oggetto rappresenta un target di richiesta diverso.

Esempi di endpoint interessati

Recupero dello stato

• GET /agreements/{agreementId) : recupera lo stato corrente di un accordo.
• GET /agreements/{agreementId)/documents/{documentId): recupera il flusso di file di un documento all’interno di un accordo.

Elenchi, eventi e documenti di libreria

• GET /agreements : recupera gli accordi per l’utente.
• GET /agreements/{agreementId}/events: recupera le informazioni degli eventi per un accordo.
• GET /libraryDocuments — Recupera i documenti di libreria per l’utente.
• GET /libraryDocuments/{libraryDocumentId} — Recupera le informazioni per un documento di libreria specifico.

Dettagli sui criteri di polling

L’Intervallo minimo di polling oggetto (MOPI) definisce la frequenza con cui lo stesso utente effettivo può effettuare la stessa richiesta GET API al servizio Acrobat Sign.

Il MOPI predefinito varia in base al livello di servizio:

• Livelli GLOBAL, ENTERPRISE e DEVELOPER: Tre chiamate identiche per intervallo di un minuto.
• Tutti gli altri livelli: tre chiamate identiche ogni intervallo di tre minuti.

Se lo stesso utente effettivo effettua richieste GET identiche più frequentemente rispetto a quanto consentito dal livello, Acrobat Sign restituisce una risposta 429 Troppe richieste con un’intestazione Riprova più tardi.

Una richiesta è considerata identica quando lo stesso utente effettivo effettua la stessa richiesta GET con lo stesso percorso di richiesta e le stesse intestazioni entro l’intervallo di sondaggio applicabile.

Gestione ETag

Le applicazioni possono continuare a utilizzare ETag e l’intestazione If-None-Match per gli endpoint che supportano le richieste GET condizionali.

Per le richieste GET condizionali consentite sotto la soglia di sondaggio, Acrobat Sign può restituire 304 Not Modified quando la risorsa non è cambiata.

Quando la soglia di sondaggio viene superata, Acrobat Sign restituisce 429 Too Many Requests con un’intestazione Retry-After, anche quando la richiesta include un’intestazione If-None-Match.

Azioni necessarie

Se la tua applicazione richiede aggiornamenti quasi in tempo reale, utilizza i webhook invece del polling. I webhook forniscono un modo più efficiente e scalabile per ricevere aggiornamenti tempestivi.

Se non è possibile implementare i webhook, le applicazioni dovrebbero ricorrere alla memorizzazione nella cache lato client per archiviare e riutilizzare le risposte API.

• Se viene ricevuta una risposta 304 Non modificato, utilizza i dati memorizzati nella cache invece di effettuare un’altra chiamata API.
• Se viene ricevuta una risposta 429 Troppe richieste, riprova a effettuare la chiamata API solo dopo il numero di secondi specificato nell’intestazione Riprova più tardi.

Risorse

• Gestione delle risposte 429: https://developer.adobe.com/acrobat-sign/docs/overview/developer_guide/apiusage#handling-rate-limiting-http-429
• Soglia di polling dell’API: https://developer.adobe.com/acrobat-sign/docs/overview/developer_guide/apiusage#get-endpoints

Linea temporale

Le soglie MOPI aggiornate sono già in produzione.

• Il comportamento di limitazione ETag aggiornato è incluso nella versione 17.1.1. Dopo questa modifica, Acrobat Sign restituisce 429 Too Many Requests per le richieste limitate, incluse le richieste GET condizionali che includono un’intestazione If-None-Match.
• La policy di sondaggio è impostata su ENFORCED per i nuovi account nell’ambiente Sandbox dall’11 febbraio 2026.
• La policy di sondaggio è impostata su ENFORCED per i nuovi account nell’ambiente di produzione dal 5 aprile 2026.

Contatta il tuo CSM se hai bisogno di assistenza o hai domande.