技術的なお知らせ

システムの安定性を維持し、パフォーマンスを向上させるため、Adobe Acrobat Sign は GET API エンドポイントに対するポーリングしきい値を導入しています。 このポリシーは、クライアントアプリケーションが Acrobat Sign サービスに同じ API 呼び出しを行う頻度を制限します。

高頻度のポーリングはバックエンドシステムに不要な負荷をかけ、パフォーマンスの低下や応答時間の遅延を引き起こす場合があります。 API 開発者は、ほぼリアルタイムの更新に、反復的なポーリングではなく、webhook を使用することをお勧めします。

変更点

このポーリングポリシーは、同一内容の呼び出しについてすべての GET API エンドポイントに適用されます。

同じ実効ユーザーが Acrobat Sign に同じ API 呼び出しを行える頻度に制限が適用されます。 同じ実効ユーザーが、適用されるポーリングしきい値が許可するよりも頻繁に同じ呼び出しを行った場合、エラーが返されます。

例えば、同じ契約書またはライブラリ文書の同じエンドポイントへの反復的なリクエストは、同じ呼び出しとして扱われます。 異なる契約書またはライブラリ文書へのリクエストは、各オブジェクトが異なるリクエストターゲットを表すため、異なる呼び出しとして扱われます。

影響を受けるエンドポイントの例

ステータス取得

• GET /agreements/{agreementId} — 契約書の現在のステータスを取得します。
• GET /agreements/{agreementId}/documents/{documentId} — 契約書内の文書のファイルストリームを取得します。

一覧、イベント、およびライブラリ文書

• GET /agreements — ユーザーの契約書を取得します。
• GET /agreements/{agreementId}/events — 契約書のイベント情報を取得します。
• GET /libraryDocuments — ユーザーのライブラリ文書を取得します。
• GET /libraryDocuments/{libraryDocumentId} — 特定のライブラリ文書の情報を取得します。

ポーリングポリシーの詳細

最小オブジェクトポーリング間隔（MOPI）は、同じ実効ユーザーが Acrobat Sign サービスに対して同じ GET API リクエストを行える頻度を定義します。

デフォルトの MOPI はサービス階層によって異なります。

• GLOBAL、ENTERPRISE、および DEVELOPER 階層：1 分間隔で 3 回の同じ呼び出し。
• その他すべての階層：3 分間隔で 3 回の同じ呼び出し。

同じ実効ユーザーが階層で許可されているよりも頻繁に同じ GET リクエストを実行した場合、Adobe Acrobat Sign で Retry-After ヘッダーを含む 429 Too Many Requests 応答が返されます。

同じ実効ユーザーが適用されるポーリング間隔内で同じリクエストパスとヘッダーで同じ GET リクエストを行う場合、リクエストは同一であると見なされます。

ETag の処理

アプリケーションは、条件付き GET リクエストをサポートするエンドポイントに対して ETag と If-None-Match ヘッダーを引き続き使用できます。

ポーリングしきい値で許可される条件付き GET リクエストで、リソースが変更されていない場合、Acrobat Sign で 304 Not Modified が返される場合があります。

ポーリングしきい値を超えた場合、リクエストに If-None-Match ヘッダーが含まれていても、Adobe Acrobat Sign は Retry-After ヘッダー付きの 429 Too Many Requests を返します。

必要な対応

アプリケーションがほぼリアルタイムの更新を必要とする場合は、ポーリングの代わりに webhook を使用します。 Webhook は、タイムリーな更新を受け取るためのより効率的でスケーラブルな方法を提供します。

Webhook が実装できない場合は、クライアントサイドキャッシュを使用し、API 応答を保存して再利用する必要があります。

• 304 Not Modified 応答を受信した場合、別の API 呼び出しを行う代わりにキャッシュされたデータを使用します。
• 429 Too Many Requests 応答を受信した場合は、Retry-After ヘッダーで指定されている秒数後のみに API 呼び出しを再試行してください。

リソース

• 429 レスポンスの処理：https://developer.adobe.com/acrobat-sign/docs/overview/developer_guide/apiusage#handling-rate-limiting-http-429
• API ポーリングのしきい値：https://developer.adobe.com/acrobat-sign/docs/overview/developer_guide/apiusage#get-endpoints

タイムライン

更新された MOPI しきい値は既に本番環境で適用されています。

• 更新された ETag スロットリング動作は 17.1.1 リリースに含まれています。 この変更後、Acrobat Sign は、If-None-Match ヘッダーを含む条件付き GET リクエストを含む、スロットリングされたリクエストに対して 429 Too Many Requests を返します。
• ポーリングポリシーは、2026 年 2 月 11 日に Sandbox 環境の新しいアカウントに対して ENFORCED に設定されます。
• ポーリングポリシーは、2026 年 4 月 5 日に本番環境の新しいアカウントに対して ENFORCED に設定されます。

サポートが必要な場合や質問がある場合は、担当の CSM にお問い合わせください。