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

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

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

При использовании действительного токена API-интерфейса для выполнения обычных задач наиболее распространенными ошибками являются 403, 404 и 500. Ошибка 403 обычно указывает на один из трех сценариев:

Токен, используемый в запросе, и/или пользователь, которому принадлежит токен, не имеет достаточных прав доступа к области учетной записи Frame.io, где выполнялся запрос ресурса.
Токен не имеет достаточных областей доступа для запрошенного ресурса. Например, вызов GET /comments/ без области доступа comments.read.
Проблема сетевого трафика не дает API-интерфейсу Frame.io выполнить обработку запроса. Если вы подозреваете, что ваши запросы блокируются из-за проблемы с сетевым трафиком, обратитесь в службу поддержки.

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

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

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

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

Ознакомьтесь с нашим руководством по лимитам запросов, чтобы узнать больше.