> This page is for Платформа, version Предыдущая версия.
> For other versions, use one of these documentation indexes:
> - V4 (default): https://next.developer.frame.io/platform/v4/llms.txt
> - Версия 4 экспериментальная: https://next.developer.frame.io/platform/v4-experimental/llms.txt
> - Предыдущая версия: https://next.developer.frame.io/platform/v2/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://next.developer.frame.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://next.developer.frame.io/_mcp/server.

# Ограничения частоты запросов

# Обзор

Независимо от того, распространяется ли токен через портал разработчиков, предоставление OAuth или серверную часть Accounts, которая обслуживает собственные приложения Frame.io, **все вызовы API к Frame.io имеют ограничения частоты запросов.** Ограничения частоты запросов применяются ко всем запросам API от отдельного пользователя (независимо от того, какой токен или метод аутентификации используется), расходуются и пополняются постепенно, и отражаются в заголовках ответов каждого запроса к API-интерфейсу Frame.io. Для каждой конечной точки настроены собственные ограничения, которые варьируются от `10` запросов/минуту до `100` запросов/секунду. Запросы, превышающие установленное ограничение для определенной конечной точки, получают ошибку `429` HTTP в ответ.

## Расход и пополнение

API-интерфейс Frame.io использует стратегию [дырявого ведра](https://wikipedia.org/wiki/Leaky_bucket) для прогрессивного ограничения частоты запросов, при котором лимиты восстанавливаются постепенно в течение отведенного временного окна. Другими словами, не применяется полный сброс, после которого происходит восстановление лимитов для конкретного ресурса, что характерно для стратегий «фиксированного» и «скользящего окна». Вместо этого оставшиеся лимиты постоянно обновляются со скоростью, пропорциональной общему лимиту ресурса и его временному окну.

### Экспоненциальная задержка




Наша рекомендуемая стратегия для управления ограничениями частоты запросов обычно называется «экспоненциальной задержкой».





Вкратце:




* При получении ошибки `429` приостановите на определенный период (обычно на одну секунду).
* Если снова возвращается ошибка `429`, увеличивайте период ожидания экспоненциально до тех пор, пока не будет восстановлена нормальная работа.




## Заголовки




Ответы на запросы API-интерфейса всегда будут включать следующие три заголовка, которые следует использовать для ограничения ваших исходящих запросов:




| Заголовок | Значение |
| ---------- | ---------- |
| `x-ratelimit-limit` | Лимит частоты запросов для данного пути к ресурсу, измеряемый в количестве запросов. |
| `x-ratelimit-remaining` | Количество запросов, оставшихся в текущем временном окне. |
| `x-ratelimit-window` | Временное окно для ограничений, действующих для данного пути к ресурсу, измеряемое в миллисекундах (мс). |




### Пример

Следующий пример взят из ответа на запрос `GET v2/assets/:id/children` для получения дочерних ресурсов корневой папки проекта, папки или стека версий. Ограничение для этого пути составляет 40 запросов за 60 000 мс (одну минуту), и остается 39 запросов после того, как один был сделан.

```
x-ratelimit-limit → 40
x-ratelimit-remaining → 39
x-ratelimit-window → 60000
```





## Сведения

Ограничения частоты запросов сильно различаются для разных путей ресурсов в API-интерфейсе Frame.io. Ниже приведены некоторые избранные сведения для удобства чтения в формате «ресурс – действие» (например, «Ресурсы – Обновление» вместо `PUT /assets/:id`).

Как правило, пути к ресурсам, которые создают новые данные, ограничены частотой до 100 вызовов в минуту, а пути к ресурсам, которые получают списки ресурсов, ограничены 200 вызовами в минуту.




| Ресурс | Действие | Ограничение (запросы) | Окно ограничения (мс) |
| ---------- | ---------- | ---------- | ---------- |
| **Ресурсы** | `создание` | `5` | 1000 |
| **Ресурсы** | `обновление` | `10` |
| **Ресурсы** | `чтение` | `5` | 1000 |
| **Комментарии<br />Презентации<br />Проекты<br />Ссылки для рецензирования<br />Команды<br />Участники команды** | `создание` | `100` | 60 000 |
| **Поиск** | `чтение` | `200` | 60 000 |