TabBuilder REST API v1

API RESTful para integración con clientes externos (Flutter, React, CLI). Todos los endpoints retornan JSON. La autenticación usa Bearer Token de GitHub.

OpenAPI compatible Bearer Auth SignalR real-time

Base URL

https http://localhost:5001/api/v1

Autenticación

Los endpoints protegidos requieren el GitHub access token en el header:

Authorization: Bearer <github_access_token>
Los endpoints marcados con Auth requerida devuelven 401 si el token es inválido o falta el header.

Autenticación

1 endpoint
GET /api/v1/auth/me Información del usuario autenticado
Auth
Probar endpoint
GET http://localhost:5001/api/v1/auth/me

Catálogo

6 endpoints
GET /api/v1/catalog/architectures Arquitecturas disponibles (C#, Java, Python…)
Público
Probar endpoint
GET http://localhost:5001/api/v1/catalog/architectures
GET /api/v1/catalog/frameworks/{architecture} Frameworks para una arquitectura dada
Público
Parámetro: architecture: DotNet | Java | Python | Php | JavaScript | TypeScript
Probar endpoint
GET http://localhost:5001/api/v1/catalog/frameworks/{architecture}
GET /api/v1/catalog/databases Bases de datos disponibles
Público
Probar endpoint
GET http://localhost:5001/api/v1/catalog/databases
GET /api/v1/catalog/infrastructure Opciones de infraestructura
Público
Probar endpoint
GET http://localhost:5001/api/v1/catalog/infrastructure
GET /api/v1/catalog/patterns/{arch}/{framework} Patrones de diseño para el stack
Público
Probar endpoint
GET http://localhost:5001/api/v1/catalog/patterns/{arch}/{framework}
GET /api/v1/catalog/libraries/{arch}/{framework} Librerías disponibles para el stack
Público
Probar endpoint
GET http://localhost:5001/api/v1/catalog/libraries/{arch}/{framework}

IA

1 endpoint
POST /api/v1/ai/suggest Sugerencias de patrones y librerías con IA
Auth
Probar endpoint
POST http://localhost:5001/api/v1/ai/suggest

Proyectos

6 endpoints
GET /api/v1/projects Lista proyectos del usuario autenticado
Auth
Probar endpoint
GET http://localhost:5001/api/v1/projects
POST /api/v1/projects Crea y registra un nuevo proyecto
Auth
Probar endpoint
POST http://localhost:5001/api/v1/projects
GET /api/v1/projects/{id} Detalle completo del proyecto
Auth
Probar endpoint
GET http://localhost:5001/api/v1/projects/{id}
GET /api/v1/projects/{id}/logs Logs de generación del proyecto
Auth
Probar endpoint
GET http://localhost:5001/api/v1/projects/{id}/logs
POST /api/v1/projects/{id}/generate Inicia la generación del proyecto
Auth
Probar endpoint
POST http://localhost:5001/api/v1/projects/{id}/generate
DELETE /api/v1/projects/{id} Elimina permanentemente el proyecto
Auth
Probar endpoint
DELETE http://localhost:5001/api/v1/projects/{id}

Tiempo real — SignalR

La generación emite eventos en tiempo real vía WebSockets. Hub:

ws http://localhost:5001/hubs/generation
EVENT ReceiveLog Emite cada línea de log durante la generación (string step, string message, bool isError)
EVENT StatusChanged Emite cuando el estado del proyecto cambia (int projectId, string status)