# Kết nối qua API {/* #connect-via-api */}

Dùng API công khai liệt kê/đọc danh mục từ ứng dụng. Chọn [gRPC](/docs/vi/api/grpc) cho máy khách sinh mã (gồm gRPC-Web), hoặc [REST](/docs/vi/api/rest) cho JSON HTTP.

## Trước khi bắt đầu {/* #before-you-start */}

1. Vào [Reconstruct Platform](https://reconstruct.dev/platform/), **Settings → API tokens**, tạo phạm vi **Platform API** (`api`). Sao chép bí mật, chỉ hiện một lần.
2. Đặt `CR_RECONSTRUCT_API_TOKEN` trong môi trường máy khách phía máy chủ. Token chỉ MCP không xác thực PlatformService.
3. REST dùng `https://reconstruct.dev/api/v1/platform`; gRPC-Web dùng `https://reconstruct.dev`; gRPC gốc kết nối `reconstruct.dev:443` qua TLS.

Gửi `Authorization: Bearer <token>` mỗi lần.

## Chọn kiểu API {/* #choose-an-api-style */}

| Kiểu | Endpoint công khai | Hướng dẫn |
|---|---|---|
| gRPC | `reconstruct.dev:443` cho gRPC gốc; `https://reconstruct.dev` cho gRPC-Web | [Tổng quan/tạo máy khách](/docs/vi/api/grpc) |
| REST | `https://reconstruct.dev/api/v1/platform` | [Endpoint và ví dụ](/docs/vi/api/rest) |

Hai kiểu có danh sách, phiên bản, insight, tệp/xuất và yêu cầu người gọi. Dùng `nextPageToken` (REST)/`next_page_token` (gRPC) cho trang tiếp. ID lấy từ danh sách.

Dùng `CreateRequest`, `ListRequests`, `GetRequest` để gửi/theo dõi yêu cầu. Duyệt trước thu thập; phản hồi có quyết định, an toàn, tiến độ.