Технические уведомления

Для поддержания стабильности системы и повышения производительности Adobe Acrobat Sign вводит пороговое ограничение опроса для конечных точек GET API. Эта политика ограничивает частоту выполнения клиентскими приложениями идентичных вызовов API к службе Adobe Acrobat Sign.

Высокая частота опроса создает ненужную нагрузку на серверные системы, что может снизить производительность и замедлить время отклика. Разработчикам API рекомендуется использовать веб-перехватчики для получения обновлений в режиме, близком к реальному времени, вместо повторного опроса.

Что изменится

Политика опроса применяется ко всем конечным точкам GET API для идентичных вызовов.

Установлено ограничение на частоту выполнения одного и того же вызова API к Acrobat Sign от имени одного и того же эффективного пользователя. Возвращается ошибка, если один и тот же пользователь выполняет идентичные вызовы чаще, чем позволяет применимый порог опроса.

Например, повторный запрос к той же конечной точке для того же соглашения или документа библиотеки рассматривается как одинаковый вызов. Запросы для разных соглашений или документов библиотеки обрабатываются как отдельные вызовы, поскольку каждый объект представляет собой отдельную цель запроса.

Примеры затронутых конечных точек

Получение статуса

• GET /agreements/{agreementId} — Получение текущего статуса соглашения.
• GET /agreements/{agreementId}/documents/{documentId} — Получение потока данных файла документа, входящего в состав соглашения.

Списки, события и документы библиотеки

• GET /agreements — получает соглашения для пользователя.
• GET /agreements/{agreementId}/events — извлекает информацию о событиях для соглашения.
• GET /libraryDocuments — извлекает документы библиотеки для пользователя.
• GET /libraryDocuments/{libraryDocumentId} — извлекает информацию для конкретного документа библиотеки.

Сведения о политике опроса

Минимальный интервал опроса объекта (MOPI) определяет, как часто один и тот же эффективный пользователь может отправлять идентичный GET-запрос к API службы Acrobat Sign.

MOPI по умолчанию зависит от уровня обслуживания.

• Уровни GLOBAL, ENTERPRISE и DEVELOPER: три одинаковых вызова за интервал в одну минуту.
• Все остальные уровни: три идентичных вызова за трехминутный интервал.

Если один и тот же эффективный пользователь отправляет идентичные GET-запросы чаще, чем это разрешено для данного уровня, Acrobat Sign возвращает ответ с кодом 429 Too Many Requests и заголовком Retry-After.

Запрос считается одинаковым, если один и тот же действующий пользователь отправляет один и тот же запрос GET с тем же путем запроса и заголовками в течение применимого интервала опроса.

Обработка ETag

Приложения могут продолжать использовать ETag и заголовок If-None-Match для конечных точек, поддерживающих условные запросы GET.

Для условных запросов GET, не превышающих пороговое значение частоты опроса, Acrobat Sign может возвращать код 304 Not Modified, если ресурс не изменился.

При превышении порога опроса Acrobat Sign возвращает 429 Too Many Requests с заголовком Retry-After, даже если запрос включает заголовок If-None-Match.

Требуемое действие

Если вашему приложению требуются обновления в режиме, близком к реальному времени, используйте веб-перехватчики вместо опроса. Веб-перехватчики обеспечивают более эффективный и масштабируемый способ получения своевременных обновлений.

Если веб-перехватчики нельзя реализовать, приложениям следует использовать кэширование на стороне клиента для сохранения и повторного использования ответов API.

• При получении ответа 304 Not Modified используйте кэшированные данные вместо повторного вызова API.
• При получении ответа 429 Too Many Requests повторяйте вызов API только по истечении времени, указанного в заголовке Retry-After.

Ресурсы

• Обработка ответов 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 возвращает 429 Too Many Requests для запросов, ограниченных по частоте, включая условные запросы GET с заголовком If-None-Match.
• Политика опроса установлена в ENFORCED для новых учетных записей в изолированной программной среде 11 февраля 2026 г.
• Политика опроса установлена в ENFORCED для новых учетных записей в рабочей среде 5 апреля 2026 г.

Если вам нужна помощь или у вас возникли вопросы, обратитесь к своему менеджеру по работе с клиентами.