# 通过 API 连接 {/* #connect-via-api */}

在自己的应用中使用公共 API 列出采集目录并读取目录详情。需要生成客户端时选择 [gRPC](/docs/zh/api/grpc)（包括浏览器所用的 gRPC-Web）；需要通过 HTTP 使用 JSON 时选择 [REST](/docs/zh/api/rest)。

## 开始之前 {/* #before-you-start */}

1. 登录 [Reconstruct 平台](https://reconstruct.dev/platform/)，打开 **Settings → API tokens**（设置 → API 令牌），创建具有 **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/zh/api/grpc) |
| REST | `https://reconstruct.dev/api/v1/platform` | [端点和示例](/docs/zh/api/rest) |

两种风格均提供目录列表、版本详情、洞察、存储文件和导出，以及调用方的请求。使用返回的 `nextPageToken`（REST）或 `next_page_token`（gRPC）请求下一页。从列表响应中获取目录 ID。

使用 `CreateRequest`、`ListRequests` 和 `GetRequest` 提交产品并跟踪自己的请求。采集前会审核请求。响应显示决策、安全状态和采集进度。