Technická oznámení

Společnost Adobe zavádí práh dotazování pro koncové body GET API aplikace Adobe Acrobat Sign, aby pomohla udržet stabilitu systému a zlepšit výkon.Tato zásada omezuje, jak často mohou klientské aplikace provádět identické volání API ke službě Acrobat Sign.

Vysokofrekvenční dotazování vytváří zbytečnou zátěž na backendové systémy, což může snížit výkon a zpomalit dobu odezvy.Vývojářům API doporučujeme používat webhooky pro aktualizace téměř v reálném čase namísto opakovaného dotazování.

Co se změní

Zásada dotazování se vztahuje na všechny koncové body GET API pro identická volání.

Je použit limit na to, jak často může stejný efektivní uživatel provést stejné volání API do Acrobat Sign.Když stejný efektivní uživatel provádí identická volání častěji, než povoluje příslušný práh dotazování, je vrácena chyba.

Například opakovaný požadavek na stejný koncový bod pro stejnou smlouvu nebo dokument knihovny je považován za identické volání.Požadavky na různé smlouvy nebo dokumenty knihovny jsou považovány za odlišná volání, protože každý objekt představuje jiný cíl požadavku.

Příklady ovlivněných koncových bodů

Načítání stavu

• GET /agreements/{agreementId} — Načítá aktuální stav smlouvy.
• GET /agreements/{agreementId}/documents/{documentId} — Načítá datový proud souboru dokumentu v rámci smlouvy.

Výpisy, události a dokumenty knihovny

• GET /agreements — Načítá smlouvy pro uživatele.
• GET /agreements/{agreementId}/events — Načítá informace o událostech pro smlouvu.
• GET /libraryDocuments — Načítá dokumenty knihovny pro uživatele.
• GET /libraryDocuments/{libraryDocumentId} — Načítá informace pro konkrétní dokument knihovny.

Podrobnosti zásad dotazování

Minimální interval dotazování objektu (MOPI) definuje, jak často může stejný efektivní uživatel provést stejný požadavek GET API na službu Acrobat Sign.

Výchozí MOPI se liší podle úrovně služby:

• Úrovně GLOBAL, ENTERPRISE a DEVELOPER: Tři identická volání za jednominutový interval.
• Všechny ostatní úrovně: Tři identická volání za tříminutový interval.

Pokud stejný efektivní uživatel provádí identické požadavky GET častěji, než úroveň povoluje, Acrobat Sign vrátí odpověď 429 Too Many Requests s hlavičkou Retry-After.

Požadavek je považován za identický, když stejný efektivní uživatel provede stejný požadavek GET se stejnou cestou požadavku a hlavičkami v rámci příslušného intervalu dotazování.

Zpracování ETag

Aplikace mohou nadále používat ETags a hlavičku If-None-Match pro koncové body, které podporují podmíněné požadavky GET.

Pro podmíněné požadavky GET, které jsou povoleny pod prahem dotazování, může Acrobat Sign vrátit 304 Not Modified, když se prostředek nezměnil.

Když je překročen práh dotazování, Acrobat Sign vrátí 429 Too Many Requests s hlavičkou Retry-After, i když požadavek obsahuje hlavičku If-None-Match.

Požadovaná akce

Pokud vaše aplikace vyžaduje aktualizace téměř v reálném čase, použijte webhooks namísto dotazování.Webhooky poskytují efektivnější a škálovatelnější způsob, jak získávat včasné aktualizace.

Pokud webhooks nelze implementovat, aplikace by měly používat ukládání do mezipaměti na straně klienta pro uložení a opětovné použití odpovědí API.

• Když obdržíte odpověď 304 Not Modified, použijte data z mezipaměti namísto dalšího volání API.
• Když obdržíte odpověď 429 Too Many Requests, opakujte volání API až po uplynutí počtu sekund uvedeném v hlavičce Retry-After.

Zdroje

• Zpracování odpovědí 429: https://developer.adobe.com/acrobat-sign/docs/overview/developer_guide/apiusage#handling-rate-limiting-http-429
• Práh dotazování API: https://developer.adobe.com/acrobat-sign/docs/overview/developer_guide/apiusage#get-endpoints

Časová osa

Aktualizované prahové hodnoty MOPI jsou již v produkci.

• Aktualizované chování omezování ETag je zahrnuto ve verzi 17.1.1.Po této změně Acrobat Sign vrátí 429 Too Many Requests pro omezené požadavky, včetně podmíněných požadavků GET, které obsahují hlavičku If-None-Match.
• Zásady dotazování jsou nastaveny na ENFORCED pro nové účty v prostředí Sandbox dne 11. února 2026.
• Zásady dotazování jsou nastaveny na ENFORCED pro nové účty v produkčním prostředí dne 5. dubna 2026.

Pokud potřebujete pomoc nebo máte nějaké dotazy, kontaktujte prosím svého CSM.