> 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
> - V4 Experimental: 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 エラーコード

Frame.io API は、次の一般的なエラーを返すことがあります。

| コード| 詳細| 理由
|----------|----------|----------|
| `401`| **承認なし** -- 無効な API トークンです。ベアラートークン認証を使用していること、および承認ヘッダーを介してトークンを渡していることを確認してください。| |
| `402`| **使用量超過** -- Frame.io プランの制限を超えました。| |
| `403`| **禁止** -- そのリソースへのアクセス権がありません。ユーザーアクセスとトークンスコープのどちらについても返されます。| |
| `404`| **見つかりません** -- リソースが見つかりません。| リソースは移動または削除されました。|
| `422`| **無効な引数** -- 指定された 1 つ以上のパラメーターが無効でした。| |
| `429`| **レート制限** --API のレート制限に達しました。| |
| `500`| **サーバーエラー** -- サーバーがリクエストの解釈方法を認識していないか、リクエストを所定の時間内（30 秒以内）に完了できませんでした。| リクエストの URL または本文の形式が正しくないか、他の理由で完了できません。|

# 一般的なエラーのトラブルシューティング
有効な API トークンを使用して一般的なタスクを実行する場合、最もよくあるエラーは `403`、`404`、`500` です。

**403** エラーは通常、次の 3 つのシナリオのいずれかを示します。

1. リクエストで使用されているトークン、またはトークンが属するユーザー、あるいはその両方に、リクエストされたリソースの Frame.io アカウント領域への十分なアクセス権がありません。
2. リクエストされたリソースに対する十分な[スコープ]がトークンにありません。例：`comments.read` スコープなしでの `GET /comments/` の呼び出し。
3. ネットワークトラフィックの問題により、Frame.io API がリクエストを処理できません。  *ネットワークトラフィックの問題によってリクエストがブロックされていると思われる場合は、カスタマーサポートにお問い合わせください。*

**404** エラーは通常、リソースが存在しなくなったこと、すなわちリソースが移動または削除されたことを示します。

**500** エラーは通常、リクエストの URL または本文の形式が正しくないことを示しますが、所定の時間内（30 秒以内）にリクエストを完了できない場合にも発生する可能性があります。

# レート制限
Frame.io API は、トークンごとにレート制限を適用します。トークンのデフォルトの制限は、1 秒あたり呼び出し 50 回です。一部のメソッドでは制限が低く設定されています（例えば、POST `/assets/:id/children` のレート制限は 1 秒あたりアセット 5 個）。

すべての制限は変更される可能性があり、該当すると 429 HTTP エラーが返されます。レート制限の処理には指数関数バックオフアプローチの採用をお勧めします。

詳細については、レート制限に関する[ガイド](./rate-limits)をご覧ください。