Лимиты
Лимиты считаются на аккаунт: все его ключи делят один бюджет. Точные числа твоего тарифа возвращает 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 частей; больше — 429UPLOAD_USER_BUSYсRetry-After. - Занятый сервер отвечает 503
UPLOAD_SERVER_BUSYсRetry-After; ничего не сохраняется. - Тело, которое перестало приходить, сбрасывается: 30 секунд для
POST /uploads, 20 секунд для части (408UPLOAD_STALLED).
Другие ограничения
| Что | Лимит |
|---|---|
| Тело JSON | 1 МБ |
| Заметка | 200 000 символов |
| Название | 180 символов |
| Теги | до 10, по 1–32 символа |
| Список файлов | 25 на страницу |
| media-status | до 25 id за запрос |
| Загрузка по частям | части по 2 МБ, до 50 частей, до 10 незавершённых, 24 часа |
| Повтор загрузки (Idempotency-Key) | не меньше 24 часов |
| Просмотры по дням | от 1 до 90 дней |
| Журнал запросов | последние 100 за 30 дней |