Лимиты
Чтобы защитить сервис и обеспечить стабильную работу для всех, API применяет несколько ограничений.
Частота запросов
Базовый лимит — 60 запросов в минуту на токен (при отсутствии токена — на IP-адрес). Тарифные планы могут повышать этот лимит.
При превышении возвращается 429. В этом случае сделайте паузу и повторите
запрос позже (экспоненциальная задержка — хорошая практика).
Чтение значений
| Ограничение | Значение | Что означает |
|---|---|---|
| Размер страницы | до 1000 строк за ответ | даже без limit сервер отдаёт не больше и выставляет hasMore |
Диапазонов в batchGet | до 20 | больше — вернётся 422 |
Как листать большие диапазоны — см. Пагинация.
Вебхуки
| Ограничение | Значение |
|---|---|
| Число подписок | зависит от тарифа |
| Ячеек в одном уведомлении | до 500 (при превышении payload обрезается, а cellCount показывает полное число) |
| Коалесцирование | близкие по времени правки объединяются в одно уведомление (окно ~10 сек) |
| Повторные попытки | до 5, с нарастающей задержкой |
Токены и подписки
Число активных токенов и вебхуков ограничено тарифом. Значения для вашего тарифа видны в настройках аккаунта.
Рекомендации
- Читайте данные диапазонами и страницами, а не «всё сразу».
- Группируйте запись через
batchUpdateвместо множества отдельных запросов. - Обрабатывайте
429: пауза и повтор, а не немедленное повторение в цикле.