# Подключение через API {/* #connect-via-api */}

Используйте публичный API для списка каталогов захватов и чтения подробностей из своего приложения. Выберите [gRPC](/docs/ru/api/grpc) для генерируемых клиентов, включая gRPC-Web для браузеров, или [REST](/docs/ru/api/rest) для JSON по HTTP.

## Перед началом {/* #before-you-start */}

1. Войдите в [Reconstruct Platform](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 подключаются к `reconstruct.dev:443` по TLS.

Передавайте токен как `Authorization: Bearer <token>` в каждом запросе.

## Выбор вида API {/* #choose-an-api-style */}

| Вид | Публичная конечная точка | Руководства |
|---|---|---|
| gRPC | `reconstruct.dev:443` для нативного gRPC; `https://reconstruct.dev` для gRPC-Web | [Обзор и генерация клиентов](/docs/ru/api/grpc) |
| REST | `https://reconstruct.dev/api/v1/platform` | [Конечные точки и примеры](/docs/ru/api/rest) |

Оба вида предоставляют списки каталогов, подробности версий, анализ, файлы и экспорт, а также заявки пользователя. Для следующей страницы используйте возвращённый `nextPageToken` (REST) или `next_page_token` (gRPC). ID каталогов берите из списка.

Используйте `CreateRequest`, `ListRequests` и `GetRequest` для отправки продукта и отслеживания своих заявок. Заявки рассматриваются до захвата. Ответ показывает решение, безопасность и ход захвата.