# Conectar via API {/* #connect-via-api */}

Use API pública para listar catálogos e detalhes no aplicativo. Escolha [gRPC](/docs/pt/api/grpc) para clientes gerados, incluindo gRPC-Web, ou [REST](/docs/pt/api/rest) para JSON por HTTP.

## Antes de começar {/* #before-you-start */}

1. Entre em [Reconstruct Platform](https://reconstruct.dev/platform/), abra **Settings → API tokens** e crie token com escopo **Platform API** (`api`). Copie o segredo; aparece uma vez.
2. Defina `CR_RECONSTRUCT_API_TOKEN` no ambiente do cliente de servidor. Tokens só MCP não autenticam PlatformService.
3. Use `https://reconstruct.dev/api/v1/platform` para REST e `https://reconstruct.dev` para gRPC-Web. gRPC nativo usa `reconstruct.dev:443` por TLS.

Passe `Authorization: Bearer <token>` em toda solicitação.

## Escolher um estilo de API {/* #choose-an-api-style */}

| Estilo | Endpoint público | Guias |
|---|---|---|
| gRPC | `reconstruct.dev:443` no gRPC nativo; `https://reconstruct.dev` no gRPC-Web | [Visão geral e geração de clientes](/docs/pt/api/grpc) |
| REST | `https://reconstruct.dev/api/v1/platform` | [Endpoints e exemplos](/docs/pt/api/rest) |

Ambos expõem catálogo, versões, insights, arquivos/exportações e solicitações do usuário. Use `nextPageToken` (REST) ou `next_page_token` (gRPC) na próxima página. Obtenha IDs da lista.

Use `CreateRequest`, `ListRequests` e `GetRequest` para enviar produto e acompanhar solicitações. São revisadas antes da captura; resposta mostra decisão, segurança e progresso.