# API 経由で接続する {/* #connect-via-api */}

公開 API を使い、自分のアプリケーションからキャプチャーカタログの一覧と詳細を読み取れます。生成クライアントには [gRPC](/docs/ja/api/grpc)（ブラウザー向け gRPC-Web を含む）、HTTP 上の JSON には [REST](/docs/ja/api/rest) を選びます。

## 開始前の準備 {/* #before-you-start */}

1. [Reconstruct Platform](https://reconstruct.dev/platform/) にサインインし、**Settings → API tokens** を開いて、**Platform API** スコープ（`api`）を持つトークンを作成します。シークレットは一度しか表示されないため、表示時にコピーしてください。
2. サーバー側クライアントを実行する環境で `CR_RECONSTRUCT_API_TOKEN` を設定します。MCP スコープだけを持つトークンでは PlatformService を認証できません。
3. REST は `https://reconstruct.dev/api/v1/platform`、gRPC-Web は `https://reconstruct.dev` を使います。ネイティブ gRPC クライアントは TLS 経由で `reconstruct.dev:443` に接続します。

すべてのリクエストに `Authorization: Bearer <token>` としてトークンを渡します。

## API 方式を選ぶ {/* #choose-an-api-style */}

| 方式 | 公開エンドポイント | ガイド |
|---|---|---|
| gRPC | ネイティブ gRPC は `reconstruct.dev:443`、gRPC-Web は `https://reconstruct.dev` | [概要とクライアント生成](/docs/ja/api/grpc) |
| REST | `https://reconstruct.dev/api/v1/platform` | [エンドポイントと使用例](/docs/ja/api/rest) |

どちらも、カタログ一覧、バージョン詳細、インサイト、保存済みファイル、エクスポート、呼び出し元のリクエストを公開します。次のページには返された `nextPageToken`（REST）または `next_page_token`（gRPC）を使います。カタログ ID は一覧の応答から取得します。

`CreateRequest`、`ListRequests`、`GetRequest` を使い、製品を申請して自分のリクエストを追跡します。リクエストはキャプチャー前に審査されます。応答には判断結果、安全性状態、キャプチャーの進行状況が表示されます。