Tekniske merknader

For å bidra til å opprettholde systemstabilitet og forbedre ytelsen, introduserer Adobe Acrobat Sign en spørreterskel for GET API-endepunkter. Denne policyen begrenser hvor ofte klientprogrammer kan gjøre identiske API-kall til Adobe Acrobat Sign-tjenesten.

Høyfrekvent spørring skaper unødvendig belastning på backend-systemer, noe som resulterer i redusert ytelse og tregere responstider. API-utviklere oppfordres til å bruke webhooks for nær sanntidsoppdateringer i stedet for gjentatt spørring.

Hva som endres

Spørringspolicyen gjelder for alle GET API-endepunkter for identiske kall.

Det er en grense for hvor ofte den samme effektive brukeren kan foreta det samme API-kallet til Acrobat Sign. Det returneres en feil når samme effektive bruker gjør identiske kall oftere enn den gjeldende spørreterskelen tillater.

For eksempel behandles en gjentatt forespørsel til samme endepunkt for samme avtale eller bibliotekdokument som et identisk kall. Forespørsler om forskjellige avtaler eller bibliotekdokumenter behandles som separate kall, fordi hvert objekt representerer et annet forespørselsmål.

Eksempler på berørte endepunkter

Henting av status

• GET /agreements/{agreementId} – henter gjeldende status for en avtale.
• GET /agreements/{agreementId}/documents/{documentId} – henter filstrømmen til et dokument i en avtale.

Lister, hendelser og bibliotekdokumenter

• GET /agreements – henter avtaler for brukeren.
• GET /agreements/{agreementId}/events – henter hendelsesinformasjon for en avtale.
• GET /libraryDocuments — Henter bibliotekdokumenter for brukeren.
• GET /libraryDocuments/{libraryDocumentId} — Henter informasjon for et spesifikt bibliotekdokument.

Detaljer om spørringspolicy

Minimum Object Polling Interval (MOPI) definerer hvor ofte samme effektive bruker kan gjøre samme GET API-forespørsel til Acrobat Sign-tjenesten.

Standard MOPI varierer etter tjenestenivå:

• GLOBAL-, ENTERPRISE- og DEVELOPER-nivåer: Tre identiske kall per ett minutts intervall.
• Alle andre nivåer: Tre identiske kall per tre minutters intervall.

Hvis samme effektive bruker gjør identiske GET-forespørsler oftere enn nivået tillater, returnerer Acrobat Sign et 429 Too Many Requests-svar med en Prøv igjen etter-overskrift.

En forespørsel regnes som identisk når samme effektive bruker gjør samme GET-forespørsel med samme forespørselssti og overskrifter innenfor gjeldende spørringsintervall.

ETag-håndtering

Applikasjoner kan fortsette å bruke ETags og If-None-Match-overskriften for endepunkter som støtter betingede GET-forespørsler.

For betingede GET-forespørsler som er tillatt under avspørringsterskelen, kan Adobe Acrobat Sign returnere 304 Not Modified når ressursen ikke har endret seg.

Når avspørringsterskelen overskrides, returnerer Acrobat Sign 429 Too Many Requests med en Retry-After-header, selv når forespørselen inkluderer en If-None-Match-header.

Handling kreves

Webhooker: Hvis appen din krever oppdateringer i nær sanntid, bruker du webhook i stedet for polling. Webhooks gir en mer effektiv og skalerbar måte å motta rettidige oppdateringer på.

Hvis webhooker ikke kan implementeres, bør applikasjoner implementere klientsidehurtigbufring for å lagre og gjenbruke API-svar.

• Når en 304 Not Modified-respons mottas, bør hurtigbufrede data brukes i stedet for å gjøre et nytt API-kall.
• Når et 429 Too Many Requests-svar mottas, prøver du API-anropet på nytt etter antall sekunder oppgitt i Prøv igjen-overskriften.

Ressurser

• Håndtering av 429-svar: https://developer.adobe.com/acrobat-sign/docs/overview/developer_guide/apiusage#handling-rate-limiting-http-429
• Terskel for API-spørring: https://developer.adobe.com/acrobat-sign/docs/overview/developer_guide/apiusage#get-endpoints

Tidslinje

De oppdaterte MOPI-tersklene er allerede i produksjon.

• Den oppdaterte ETag-begrensningsfunksjonaliteten er inkludert i 17.1.1-utgivelsen. Etter denne endringen returnerer Acrobat Sign 429 Too Many Requests for begrensede forespørsler, inkludert betingede GET-forespørsler som inkluderer en Hvis-ikke-samsvar-overskrift.
• Retningslinjene for avspørring er satt til ENFORCED for nye kontoer i Sandbox-miljøet 11. februar 2026.
• Avspørringspolicyen er satt til ENFORCED for nye kontoer i produksjonsmiljøet 5. april 2026.

Ta kontakt med CSM-en din hvis du trenger hjelp eller har spørsmål.