Referencia API REST
Todos los endpoints tienen el prefijo /api. Los endpoints autenticados requieren un token Bearer.
http
Authorization: Bearer <token>Una interfaz Swagger está disponible en http://localhost:3000/docs en modo desarrollo.
Autenticación
| Endpoint | Método | Descripción |
|---|---|---|
/api/auth/register | POST | Crear una cuenta |
/api/auth/login | POST | Autenticarse |
/api/auth/refresh | POST | Refrescar el token de acceso |
/api/auth/logout | POST | Invalidar el refresh token |
/api/auth/registration-status | GET | Verificar si el registro está activado |
Proyectos
| Endpoint | Método | Descripción |
|---|---|---|
/api/projects | GET | Listar proyectos visibles |
/api/projects/public | GET | Listar proyectos públicos |
/api/projects/mine | GET | Listar tus proyectos |
/api/projects | POST | Crear un proyecto |
/api/projects/:id | PATCH | Actualizar un proyecto |
/api/projects/:id | DELETE | Eliminar un proyecto |
Pipelines
| Endpoint | Método | Descripción |
|---|---|---|
/api/projects/:pid/pipelines | GET | Listar pipelines |
/api/projects/:pid/pipelines | POST | Crear un pipeline |
/api/projects/:pid/pipelines/:id | GET | Obtener un pipeline |
/api/projects/:pid/pipelines/:id | PUT | Guardar estado completo |
/api/projects/:pid/pipelines/:id/execution-plan | GET | Plan de ejecución (dry-run) |
/api/projects/:pid/pipelines/:id | DELETE | Eliminar un pipeline |
Códigos HTTP
| Código | Significado |
|---|---|
| 200 | OK |
| 201 | Creado |
| 204 | Sin contenido |
| 400 | Error de validación |
| 401 | No autenticado |
| 403 | Acceso denegado |
| 404 | Recurso no encontrado |
| 500 | Error del servidor |