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

Utiliza la API pública para listar catálogos de captura y leer sus detalles desde tu aplicación. Elige [gRPC](/docs/es/api/grpc) para clientes generados (incluido gRPC-Web para navegadores), o [REST](/docs/es/api/rest) para JSON sobre HTTP.

## Antes de empezar {/* #before-you-start */}

1. Inicia sesión en [Reconstruct Platform](https://reconstruct.dev/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.
2. Define `CR_RECONSTRUCT_API_TOKEN` en el entorno que ejecuta tu cliente de servidor. Los tokens con solo ámbito MCP no autentican PlatformService.
3. Utiliza `https://reconstruct.dev/api/v1/platform` para REST y `https://reconstruct.dev` para gRPC-Web. Los clientes gRPC nativos se conectan a `reconstruct.dev:443` mediante TLS.

Pasa el token como `Authorization: Bearer <token>` en cada solicitud.

## Elegir una modalidad de API {/* #choose-an-api-style */}

| 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](/docs/es/api/grpc) |
| REST | `https://reconstruct.dev/api/v1/platform` | [Endpoints y ejemplos](/docs/es/api/rest) |

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.
