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

Для поддержания стабильности системы и повышения производительности 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

Приложения могут продолжать использовать ETags и заголовок 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 г.

Пожалуйста, свяжитесь с вашим CSM, если вам нужна помощь или у вас есть вопросы.