通过 API 连接
在自己的应用中使用公共 API 列出采集目录并读取目录详情。需要生成客户端时选择 gRPC（包括浏览器所用的 gRPC-Web）；需要通过 HTTP 使用 JSON 时选择 REST。
开始之前
- 登录 Reconstruct 平台，打开 Settings → API tokens（设置 → API 令牌），创建具有 Platform API 作用域（
api）的令牌。密钥出现时请复制；它只显示一次。 - 在运行服务端客户端的环境中设置
CR_RECONSTRUCT_API_TOKEN。仅有 MCP 作用域的令牌无法通过 PlatformService 身份验证。 - REST 使用
https://reconstruct.dev/api/v1/platform，gRPC-Web 使用https://reconstruct.dev。原生 gRPC 客户端通过 TLS 连接至reconstruct.dev:443。
每次请求均将令牌作为 Authorization: Bearer <token> 传入。
选择 API 风格
| 风格 | 公共端点 | 指南 |
|---|---|---|
| gRPC | 原生 gRPC 使用 reconstruct.dev:443；gRPC-Web 使用 https://reconstruct.dev | 概览和客户端生成 |
| REST | https://reconstruct.dev/api/v1/platform | 端点和示例 |
两种风格均提供目录列表、版本详情、洞察、存储文件和导出，以及调用方的请求。使用返回的 nextPageToken（REST）或 next_page_token（gRPC）请求下一页。从列表响应中获取目录 ID。
使用 CreateRequest、ListRequests 和 GetRequest 提交产品并跟踪自己的请求。采集前会审核请求。响应显示决策、安全状态和采集进度。