Saltar al contenido principal

API de Proyectos

Gestiona proyectos y activa análisis.

Listar Proyectos​

GET /v1/projects

Respuesta:

{
  "success": true,
  "projects": [
    {
      "id": "proj_abc123",
      "name": "my-app",
      "status": "indexed",
      "filesCount": 234,
      "symbolsCount": 1847,
      "lastIndexedAt": "2024-01-15T10:30:00Z",
      "createdAt": "2024-01-10T08:00:00Z"
    }
  ]
}

Obtener Proyecto​

GET /v1/projects/:id

Respuesta:

{
  "success": true,
  "project": {
    "id": "proj_abc123",
    "name": "my-app",
    "status": "indexed",
    "filesCount": 234,
    "symbolsCount": 1847,
    "languages": ["typescript", "javascript"],
    "stats": {
      "linesOfCode": 15420,
      "avgComplexity": 4.2,
      "duplicatePercentage": 3.1
    },
    "lastIndexedAt": "2024-01-15T10:30:00Z",
    "createdAt": "2024-01-10T08:00:00Z"
  }
}

Crear Proyecto​

POST /v1/projects

Cuerpo de la Solicitud:

{
  "name": "my-new-project",
  "githubRepo": "owner/repo",
  "branch": "main"
}

Respuesta:

{
  "success": true,
  "project": {
    "id": "proj_xyz789",
    "name": "my-new-project",
    "status": "pending"
  }
}

Eliminar Proyecto​

DELETE /v1/projects/:id

Respuesta:

{
  "success": true
}

Activar Indexación​

POST /v1/projects/:id/index

Cuerpo de la Solicitud (opcional):

{
  "force": true
}

Respuesta:

{
  "success": true,
  "message": "Indexación iniciada",
  "estimatedTime": 120
}

Obtener Progreso de Indexación​

GET /v1/projects/:id/index-progress

Respuesta (Server-Sent Events):

event: progress
data: {"phase": "scanning", "progress": 25, "filesScanned": 58}

event: progress
data: {"phase": "extracting", "progress": 50, "symbolsExtracted": 450}

event: progress
data: {"phase": "embedding", "progress": 75, "chunksProcessed": 120}

event: complete
data: {"status": "indexed", "filesCount": 234, "symbolsCount": 1847}

Archivar Proyecto​

POST /v1/projects/:id/archive

Desarchivar Proyecto​

POST /v1/projects/:id/unarchive