Conectar via API
Use API pública para listar catálogos e detalhes no aplicativo. Escolha gRPC para clientes gerados, incluindo gRPC-Web, ou REST para JSON por HTTP.
Antes de começar
- Entre em Reconstruct Platform, abra Settings → API tokens e crie token com escopo Platform API (
api). Copie o segredo; aparece uma vez. - Defina
CR_RECONSTRUCT_API_TOKENno ambiente do cliente de servidor. Tokens só MCP não autenticam PlatformService. - Use
https://reconstruct.dev/api/v1/platformpara REST ehttps://reconstruct.devpara gRPC-Web. gRPC nativo usareconstruct.dev:443por TLS.
Passe Authorization: Bearer <token> em toda solicitação.
Escolher um estilo de API
| 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 |
| REST | https://reconstruct.dev/api/v1/platform | Endpoints e exemplos |
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.