gRPC
Comece por Conectar via API para criar token API. Clientes gRPC-Web usam https://reconstruct.dev. O gRPC nativo conecta a reconstruct.dev:443 por TLS e usa o caminho gerado a partir do nome do serviço proto. Cada chamada exige metadados authorization: Bearer <token>.
GetCaptureOptions retorna IDs de tipos e ambientes; clientes não devem manter lista fixa. CatalogPlatform.view é o tipo (desktop/mobile) e CatalogPlatform.implementation, o ambiente. Desktop admite web/web-extension/macos/windows/linux; mobile, web/ios/android. captured indica disponibilidade armazenada. MCP usa platform/environment para a mesma seleção; view da página identifica um perfil salvo. Consulte o catálogo MCP.
Baixar o contrato
curl -fsSL https://reconstruct.dev/docs/proto/platform.proto -o platform.proto
O contrato para clientes tem o mesmo serviço, mensagens e números de campo do servidor. Omite anotações HTTP para que gerar clientes não exija protos de anotações API do Google.
| RPC | Solicitação | Resultado |
|---|---|---|
ListCatalogs | page_size, page_token opcional | catalogs[], next_page_token opcional |
GetCaptureOptions | Solicitação vazia | IDs de plataforma/ambiente, padrões e opções de plataforma para solicitações; sem autenticação ou medição. |
GetCatalog | catalog_id, version opcional | Metadados, version selecionada, versions[] publicadas, screens[], opções de plataforma/idioma |
GetCatalogInsights | catalog_id, locale, view, implementation, section, version opcionais | version, technologies[], rendering, fonts[], text_styles[], assets[], color_themes[], page_count |
Use next_page_token como page_token da próxima chamada para continuar. Obtenha IDs de catálogo de ListCatalogs.
O contrato inclui GetCatalogFile (bytes e tipo, version opcional), CreateRequest, ListRequests, GetRequest e as operações de conta, aparência, avatar e tokens pessoais do guia REST. Os requisitos de acesso são iguais nas duas APIs. ListCatalogs admite busca, ordenação e filtros repetidos documentados ali.
WatchCatalogs transmite changed e revision; passe catalog_id para um catálogo ou omita para a lista e reutilize a última revision ao reconectar. WatchRequests transmite invalidações das solicitações do usuário. Atualize os dados quando changed for true. Esses fluxos usam gRPC/gRPC-Web e não têm anotação HTTP.
Gerar um cliente
Testar uma chamada com grpcurl
No diretório com platform.proto, com CR_RECONSTRUCT_API_TOKEN definido:
grpcurl \
-import-path . -proto platform.proto \
-H "authorization: Bearer ${CR_RECONSTRUCT_API_TOKEN}" \
-d '{"pageSize":10}' \
reconstruct.dev:443 \
reconstruct.platform.v1.PlatformService/ListCatalogs
Use host e porta no destino gRPC nativo, sem caminho URL.
Uso e cobrança da conta
Gerencie assinatura e uso nas configurações da plataforma. Tokens pessoais API/MCP dão acesso a catálogos e solicitações; não gerenciam cobrança.
Dados de interface normalizados
O formato Scene define artefatos independentes de plataforma, com estados, recursos e evidências. A exportação normalizada atual vem do MCP get_interface_scene; a API de catálogo não define operação Scene separada.