Technische meldingen

Om de systeemstabiliteit te behouden en de prestaties te verbeteren, introduceert Adobe Acrobat Sign een drempel voor GET API-eindpunten. Met dit beleid wordt een limiet gesteld aan het aantal keren dat clientapps identieke API-aanroepen naar de Acrobat Sign-service kunnen uitvoeren.

Polling met hoge frequentie veroorzaakt een onnodige belasting van back-endsystemen, wat de prestaties kan verminderen en reactietijden kan vertragen. API-ontwikkelaars worden aangemoedigd webhooks te gebruiken voor bijna realtime updates in plaats van herhaaldelijke polling.

Wat gaat er veranderen?

Dit polling-beleid geldt voor alle GET-API-eindpunten voor identieke aanroepen.

Er wordt een limiet gesteld aan het aantal keren dat dezelfde effectieve gebruiker dezelfde API-aanroep naar Acrobat Sign kan uitvoeren. Er wordt een fout geretourneerd wanneer dezelfde effectieve gebruiker identieke aanroepen vaker uitvoert dan de geldende polling-drempel toestaat.

Een herhaald verzoek naar hetzelfde eindpunt voor dezelfde overeenkomst of hetzelfde bibliotheekdocument wordt bijvoorbeeld behandeld als een identieke aanroep. Verzoeken voor verschillende overeenkomsten of bibliotheekdocumenten worden behandeld als verschillende aanroepen omdat elk object een ander doel van het verzoek vertegenwoordigt.

Voorbeelden van getroffen eindpunten

Status ophalen

• GET /agreements/{agreementId} – Haalt de huidige status van een overeenkomst op.
• GET /agreements/{agreementId}/documents/{documentId} – Haalt de bestandsstroom van een document binnen een overeenkomst op.

Overzichten, gebeurtenissen en bibliotheekdocumenten

• GET /agreements – Haalt overeenkomsten voor de gebruiker op.
• GET /agreements/{agreementId}/events – Haalt gebeurtenisinformatie voor een overeenkomst op.
• GET /libraryDocuments — Haalt bibliotheekmiddelen op voor de gebruiker.
• GET /libraryDocuments/{libraryDocumentId} — Haalt informatie op voor een specifiek bibliotheekdocument.

Informatie over polling-beleid

Het Minimum Object Polling Interval (MOPI) bepaalt hoe vaak dezelfde effectieve gebruiker dezelfde GET-API-aanvraag naar de Acrobat Sign-service kan verzenden.

Het standaard MOPI verschilt per servicelaag:

• GLOBAL-, ENTERPRISE- en DEVELOPER-niveaus: Drie identieke aanroepen per interval van één minuut.
• Alle andere niveaus: drie identieke aanroepen per interval van drie minuten.

Als dezelfde effectieve gebruiker identieke GET-verzoeken vaker uitvoert dan de laag toestaat, retourneert Acrobat Sign een 429 Too Many Requests-respons met een Retry-After-header.

Een aanvraag wordt als identiek beschouwd wanneer dezelfde effectieve gebruiker dezelfde GET-aanvraag doet met hetzelfde aanvraagpad en dezelfde headers binnen het toepasselijke polling-interval.

ETag-verwerking

Applicaties kunnen ETags en de If-None-Match header blijven gebruiken voor eindpunten die conditionele GET-aanvragen ondersteunen.

Voor conditionele GET-aanvragen die zijn toegestaan onder de pollingdrempel, kan Acrobat Sign 304 Not Modified retourneren wanneer de resource niet is gewijzigd.

Wanneer de polling-drempel wordt overschreden, retourneert Acrobat Sign 429 Too Many Requests met een Retry-After header, zelfs wanneer de aanvraag een If-None-Match header bevat.

Vereiste actie

Als uw toepassing bijna-realtime-updates vereist, gebruik dan webhooks in plaats van polling. Webhooks bieden een efficiëntere en schaalbaardere manier om tijdige updates te ontvangen.

Als er geen webhooks kunnen worden geïmplementeerd, moeten toepassingen caching aan klantzijde gebruiken om API-reacties op te slaan en opnieuw te gebruiken.

• Wanneer een 304 Not Modified-reactie wordt ontvangen, gebruik dan de gegevens in de cache in plaats van nog een API-aanroep uit te voeren.
• Wanneer een 429 Too Many Requests-reactie wordt ontvangen, voer de API-aanroep dan pas opnieuw uit na het aantal seconden dat is opgegeven in de Retry-After-header.

Bronnen

• 429-reacties verwerken: https://developer.adobe.com/acrobat-sign/docs/overview/developer_guide/apiusage#handling-rate-limiting-http-429
• API-peilingsdrempel: https://developer.adobe.com/acrobat-sign/docs/overview/developer_guide/apiusage#get-endpoints

Tijdlijn

De bijgewerkte MOPI-drempels zijn al in productie.

• Het bijgewerkte gedrag voor ETag-throttling is opgenomen in de 17.1.1-release. Na deze wijziging retourneert Acrobat Sign een 429 Too Many Requests-reactie voor beperkte aanvragen, inclusief conditionele GET-aanvragen die een If-None-Match-header bevatten.
• Het polling-beleid is ingesteld op ENFORCED voor nieuwe accounts in de Sandbox-omgeving op 11 februari 2026.
• Het polling-beleid is ingesteld op ENFORCED voor nieuwe accounts in de productieomgeving op 5 april 2026.

Neem contact op met je CSM als je hulp nodig hebt of vragen hebt.