Conectar mediante API
Utiliza la API pública para listar catálogos de captura y leer sus detalles desde tu aplicación. Elige gRPC para clientes generados (incluido gRPC-Web para navegadores), o REST para JSON sobre HTTP.
Antes de empezar
- Inicia sesión en Reconstruct Platform, abre Settings → API tokens (Configuración → Tokens API) y crea un token con ámbito Platform API (
api). Copia el secreto cuando aparezca; solo se muestra una vez. - Define
CR_RECONSTRUCT_API_TOKENen el entorno que ejecuta tu cliente de servidor. Los tokens con solo ámbito MCP no autentican PlatformService. - Utiliza
https://reconstruct.dev/api/v1/platformpara REST yhttps://reconstruct.devpara gRPC-Web. Los clientes gRPC nativos se conectan areconstruct.dev:443mediante TLS.
Pasa el token como Authorization: Bearer <token> en cada solicitud.
Elegir una modalidad de API
| Modalidad | Endpoint público | Guías |
|---|---|---|
| gRPC | reconstruct.dev:443 para gRPC nativo; https://reconstruct.dev para gRPC-Web | Resumen y generación de clientes |
| REST | https://reconstruct.dev/api/v1/platform | Endpoints y ejemplos |
Ambas modalidades exponen listado de catálogos, detalles de versión, insights, archivos y exportaciones, además de solicitudes del llamante. Usa nextPageToken (REST) o next_page_token (gRPC) devuelto para pedir la siguiente página. Obtén los ID de catálogo de la respuesta de lista.
Utiliza CreateRequest, ListRequests y GetRequest para enviar un producto y seguir tus solicitudes. Se revisan antes de capturar. La respuesta muestra la decisión, estado de seguridad y progreso de captura.