> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/reference/ja/purattofmu/rest-api.md).

# REST API

Roboflow REST API はプラットフォームへの公式インターフェースです。すべての機能はまずここに提供され、 [Python SDK](/reference/ja/purattofmu/python-sdk.md) と [CLI](/reference/ja/purattofmu/cli.md) はいずれも内部でこれを呼び出します。Python 以外の統合を構築している場合、Webhook やブラウザから呼び出す場合、または Python パッケージをインストールできない環境で作業している場合は、REST API を直接使用してください。

知っておくべきベースホストは 2 つあります：

| ホスト                               | 用途                                                                                                                                          |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `https://api.roboflow.com`        | 管理 - ワークスペース、プロジェクト、バージョン、学習、ワークフロー、データセット、Vision イベント、ゴミ箱。                                                                                 |
| `https://serverless.roboflow.com` | ホスティング推論 - 学習済みモデルまたはワークフローを画像や動画に対して実行します。参照： [画像上でモデルを実行する](https://docs.roboflow.com/deployment/roboflow-cloud/serverless-api#http-api). |

[専用デプロイ](https://docs.roboflow.com/deployment/roboflow-cloud/dedicated-deployments#http-api) は別のホストで管理されます（`https://roboflow.cloud`).

## リソース階層

Roboflow のデータモデルは階層構造になっており、API URL もその階層に従っています：

* `/:workspace` - ワークスペース内のプロジェクト一覧と、ワークスペースのメタデータ。
* `/:workspace/:project` - プロジェクトのメタデータとバージョン一覧。
* `/:workspace/:project/:version` - 特定のデータセットバージョン、そのモデル（学習済みの場合）、およびダウンロード URL。
* `/:workspace/:project/:version/:format` - 特定の [エクスポート形式](https://roboflow.com/formats).
* `/:workspace/workflows/:workflow` - 参照： [ワークフローの管理](https://docs.roboflow.com/workflows/manage/manage-workflows#http-api).
* `/:workspace/groups` - プロジェクトフォルダ。参照： [プロジェクトフォルダの管理](https://docs.roboflow.com/datasets/manage/project-folders#http-api).
* `/:workspace/trash` - ソフト削除されたプロジェクト、バージョン、ワークフロー。参照： [ゴミ箱の管理](https://docs.roboflow.com/platform/workspaces/trash#http-api).

## ルートエンドポイント

最上位（`https://api.roboflow.com/`）で、 `api_key` が有効であることを確認できます。レスポンスには、そのキーが属するワークスペースが表示されます：

```bash
curl -H "Authorization: Bearer $ROBOFLOW_API_KEY" "https://api.roboflow.com/"
```

```json
{
  "welcome": "Roboflow API へようこそ。",
  "instructions": "認証に成功しました。",
  "docs": "https://docs.roboflow.com",
  "workspace": "my-workspace"
}
```

そこから、 [ワークスペースとプロジェクトの一覧表示](https://docs.roboflow.com/platform/workspaces/list-workspaces-and-projects#http-api) へ進んで、ワークスペース内の内容を確認できます。

## 認証とスコープ

API キーはワークスペース単位でスコープされます。キーは `Authorization: Bearer ...` ヘッダーとして送信してください。クエリパラメータ（`?api_key=...`）または `POST` リクエストの本文に含める方法は旧方式です。今でも動作しますが、キーが URL やログに残るため、新しいコードでは推奨されません。参照： [REST API で認証する](/reference/ja/purattofmu/rest-api/authenticate-with-the-rest-api.md) で詳細を、 [スコープ付き API キー](/reference/ja/ren-zheng/authentication/scoped-api-keys.md) で各リソースのスコープ参照を確認してください。

## エラー

API は標準の HTTP ステータスコードと JSON のエラーボディを使用します。参照： [エラーとステータスコード](/reference/ja/errors-and-status-codes.md) でツール横断のエラー参照を確認してください。