Technische Mitteilungen

Um die Systemstabilität zu gewährleisten und die Leistung zu verbessern, führt Acrobat Sign einen Abfrage-Schwellenwert für GET-API-Endpunkte ein. Diese Richtlinie begrenzt, wie häufig Client-Anwendungen identische API-Aufrufe an Adobe Acrobat Sign stellen können.

Hochfrequente Abfragen erzeugen unnötige Last auf Backend-Systemen, was zu einer verminderten Leistung und langen Antwortzeiten führen kann. API-Entwickler werden ermutigt, Webhooks für nahezu Echtzeit-Updates anstelle wiederholter Abfragen zu verwenden.

Was ändert sich?

Die Abfragerichtlinie gilt für alle GET API-Endpunkte für identische Aufrufe.

Es wurde eine Begrenzung dafür eingeführt, wie oft dieselben effektiven Benutzenden denselben API-Aufruf an Acrobat Sign senden können. Ein Fehler wird zurückgegeben, wenn derselbe effektive Benutzer identische Aufrufe häufiger durchführt, als der anwendbare Polling-Schwellenwert zulässt.

Beispielsweise wird eine wiederholte Anfrage an denselben Endpunkt für dasselbe Agreement oder Bibliotheksdokument als identischer Aufruf behandelt. Anfragen für verschiedene Agreements oder Bibliotheksdokumente werden als unterschiedliche Aufrufe behandelt, da jedes Objekt ein anderes Anfrageziel darstellt.

Beispiele betroffener Endpunkte

Status-Abruf

• GET /agreements/{agreementId} – Ruft den aktuellen Status einer Vereinbarung ab.
• GET /agreements/{agreementId}/documents/{documentId} – Ruft den Datei-Stream eines Dokuments innerhalb einer Vereinbarung ab.

Auflistung, Ereignisse und Bibliotheksdokumente

• GET /agreements – Ruft Verträge für Benutzende ab.
• GET /agreements/{agreementId}/events – Ruft Ereignisinformationen für eine Vereinbarung ab.
• GET /libraryDocuments – Ruft Bibliotheksdokumente für den Benutzer ab.
• GET /libraryDocuments/{libraryDocumentId} – Ruft Informationen für ein bestimmtes Bibliotheksdokument ab.

Polling-Richtlinien-Details

Das Minimale Objekt-Abfrageintervall (MOPI) definiert, wie oft dieselben effektiven Benutzenden dieselbe GET-API-Anfrage an den Acrobat Sign-Dienst stellen können.

Die Standard-MOPI variiert je nach Servicestufe:

• GLOBAL-, ENTERPRISE- und DEVELOPER-Stufen: Drei identische Aufrufe pro Ein-Minuten-Intervall.
• Alle anderen Stufen: Drei eindeutige Aufrufe pro Zehn-Minuten-Intervall.

Wenn derselbe effektive Benutzer identische GET-Anfragen häufiger stellt, als die Ebene erlaubt, gibt Adobe Acrobat Sign eine 429 Too Many Requests-Antwort mit einem Retry-After-Header zurück.

Eine Anfrage gilt als identisch, wenn derselbe effektive Benutzer dieselbe GET-Anfrage mit demselben Anfragepfad und denselben Headern innerhalb des entsprechenden Abfrageintervalls stellt.

ETag-Behandlung

Anwendungen können weiterhin ETags und den If-None-Match-Header für Endpunkte verwenden, die bedingte GET-Anfragen unterstützen.

Für bedingte GET-Anfragen, die unter dem Befragungsschwellenwert erlaubt sind, kann Acrobat Sign 304 Not Modified zurückgeben, wenn sich die Ressource nicht geändert hat.

Wenn der Befragungsschwellenwert überschritten wird, gibt Acrobat Sign 429 Too Many Requests mit einem Retry-After-Header zurück, auch wenn die Anfrage einen If-None-Match-Header enthält.

Aktion erforderlich

Wenn die Applikation nahezu Echtzeit-Updates benötigt, verwende Webhooks anstelle von Abfragen. Webhooks bieten eine effizientere und skalierbarere Möglichkeit, zeitnahe Updates zu erhalten.

Wenn Webhooks nicht implementiert werden können, sollten Applikationen clientseitiges Caching nutzen, um API-Antworten zu speichern und wiederzuverwenden.

• Wenn eine 304 Nicht modifiziert-Antwort empfangen wird, verwende die zwischengespeicherten Daten, anstatt einen weiteren API-Aufruf zu tätigen.
• Wenn eine 429 Too Many Requests-Antwort empfangen wird, wiederhole den API-Aufruf nach der Anzahl von Sekunden, die im Retry-After-Header angegeben ist.

Ressourcen

• Behandlung von 429-Antworten: https://developer.adobe.com/acrobat-sign/docs/overview/developer_guide/apiusage#handling-rate-limiting-http-429
• API-Abfrage-Schwellenwert: https://developer.adobe.com/acrobat-sign/docs/overview/developer_guide/apiusage#get-endpoints

Zeitachse

Die aktualisierten MOPI-Schwellenwerte sind bereits in der Produktionsumgebung.

• Das aktualisierte ETag-Drosselungsverhalten ist in der Version 17.1.1 enthalten. Nach dieser Änderung gibt Acrobat Sign 429 Too Many Requests für gedrosselte Anfragen zurück, einschließlich bedingter GET-Anfragen, die einen If-None-Match-Header enthalten.
• Die Abfragerichtlinie wird für neue Konten in der Sandbox-Umgebung am 11. Februar 2026 auf ENFORCED gesetzt.
• Die Polling-Richtlinie wird für neue Konten in der Produktionsumgebung am 5. April 2026 auf ENFORCED gesetzt.

Bitte wende dich an deinen CSM, wenn du Hilfe benötigst oder Fragen hast.