К содержимому

Лимиты

Лимиты считаются на аккаунт: все его ключи делят один бюджет. Точные числа твоего тарифа возвращает GET /api/v1/account в limits.

Частота запросов

  • 60 запросов в минуту на аккаунт — для всех ключей вместе.
  • У загрузки по частям свои бюджеты: 240 запросов к загрузкам и 1200 частей в минуту.
  • В ответах есть заголовки X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset — секунды до обновления бюджета.
  • Сверх лимита — 429 RATE_LIMITED с Retry-After.

Размер файлов и место

ЧтоЛимит
ИзображениеНа бесплатном тарифе до 10 МБ (limits.maxImageBytes) и до 40 мегапикселей; у Pro лимита на файл нет — только место и предел сервера 64 МБ.
ВидеоНа бесплатном тарифе до 100 МБ (limits.maxVideoBytes); у Pro лимита на файл нет — только место и предел сервера 4 ГБ.
Место в аккаунтеКвота тарифа (user.quotaBytes); сверх неё — 413 QUOTA_EXCEEDED.

Больше места и размер файлов — в тарифах.

Одновременные загрузки

  • Аккаунт отправляет до 2 файлов POST /uploads одновременно и до 3 частей; больше — 429 UPLOAD_USER_BUSY с Retry-After.
  • Занятый сервер отвечает 503 UPLOAD_SERVER_BUSY с Retry-After; ничего не сохраняется.
  • Тело, которое перестало приходить, сбрасывается: 30 секунд для POST /uploads, 20 секунд для части (408 UPLOAD_STALLED).

Другие ограничения

ЧтоЛимит
Тело JSON1 МБ
Заметка200 000 символов
Название180 символов
Тегидо 10, по 1–32 символа
Список файлов25 на страницу
media-statusдо 25 id за запрос
Загрузка по частямчасти по 2 МБ, до 50 частей, до 10 незавершённых, 24 часа
Повтор загрузки (Idempotency-Key)не меньше 24 часов
Просмотры по днямот 1 до 90 дней
Журнал запросовпоследние 100 за 30 дней
Лимиты · API lacuna