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

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

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

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

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

Применяется ограничение на частоту выполнения одним и тем же действующим пользователем одного и того же вызова API к Adobe Acrobat Sign.Ошибка возвращается, когда один и тот же действующий пользователь выполняет идентичные вызовы чаще, чем позволяет применимый порог опроса.

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

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

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

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

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

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

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

Параметр Minimum Object Polling Interval (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.
• Для новых учетных записей в среде Sandbox политика опроса устанавливается как ENFORCED 11 февраля 2026 года.
• Политика опроса устанавливается в ENFORCED для новых учетных записей в рабочей среде 5 апреля 2026 года.

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