> 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.

# Коды ошибок API-интерфейсов

API-интерфейс Frame.io может возвращать следующие распространенные ошибки:




| Код | Сведения | Причины |
| ---------- | ---------- | ---------- |
| `401` | **Нет авторизации** — недействительный токен API-интерфейса. Используйте аутентификацию с помощью токена Bearer и передавайте токен через заголовок авторизации. |  |
| `402` | **Превышен лимит использования** — превышены ограничения вашего плана Frame.io. |  |
| `403` | **Запрещено** — у вас нет доступа к этому ресурсу. Возвращается как для пользовательского доступа, так и для области действия токена. |  |
| `404` | **Не найдено** — ресурс не найден. | Ресурс перемещен или удален. |
| `422` | **Недействительные аргументы** — один или несколько предоставленных параметров недействительны. |  |
| `429` | **Ограничение частоты запросов** — вы достигли ограничения частоты запросов для API-интерфейса. |  |
| `500` | **Ошибка сервера** — сервер не знает, как интерпретировать ваш запрос, или не смог выполнить запрос в течение доступного времени (30 секунд). | Неправильно сформирован запрос URL, тело запроса или невозможно выполнить по какой-либо другой причине. |




# Поиск и устранение распространенных ошибок

При использовании действительного токена API-интерфейса для выполнения обычных задач наиболее распространенными ошибками являются `403`, `404` и `500`. Ошибка **403** обычно указывает на один из трех сценариев:
1. Токен, используемый в запросе, и/или пользователь, которому принадлежит токен, не имеет достаточных прав доступа к области учетной записи Frame.io, где выполнялся запрос ресурса.
2. Токен не имеет достаточных [областей доступа]() для запрошенного ресурса. Например, вызов `GET /comments/` без области доступа `comments.read`.
3. Проблема сетевого трафика не дает API-интерфейсу Frame.io выполнить обработку запроса. *Если вы подозреваете, что ваши запросы блокируются из-за проблемы с сетевым трафиком, обратитесь в службу поддержки.*

Ошибка **404** обычно указывает на то, что ресурс больше не существует — перемещен или удален. Ошибка **500** обычно указывает на неправильно сформированный запрос URL или тело запроса, но также может произойти, когда мы не можем выполнить запрос в течение доступного времени (30 секунд).

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

API-интерфейс Frame.io применяет ограничения запросов для каждого токена. Лимит по умолчанию для токена составляет 50 вызовов в секунду. Некоторые методы имеют более низкие лимиты (например, POST `/assets/:id/children` ограничен до 5 ресурсов в секунду).

Все лимиты могут изменяться, и при их достижении возвращается ошибка 429 HTTP. Мы рекомендуем использовать экспоненциальный подход с откладыванием для обработки лимитов запросов.

Ознакомьтесь с [нашим руководством](./rate-limits) по лимитам запросов, чтобы узнать больше.