إنتقل إلى المحتوى الرئيسي

واجهة برمجة المشاريع

إدارة المشاريع وتشغيل التحليل.

قائمة المشاريع​

GET /v1/projects

الاستجابة:

{
  "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"
    }
  ]
}

الحصول على مشروع​

GET /v1/projects/:id

الاستجابة:

{
  "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"
  }
}

إنشاء مشروع​

POST /v1/projects

نص الطلب:

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

الاستجابة:

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

حذف مشروع​

DELETE /v1/projects/:id

الاستجابة:

{
  "success": true
}

تشغيل الفهرسة​

POST /v1/projects/:id/index

نص الطلب (اختياري):

{
  "force": true
}

الاستجابة:

{
  "success": true,
  "message": "بدأت الفهرسة",
  "estimatedTime": 120
}

الحصول على تقدم الفهرسة​

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

الاستجابة (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}

أرشفة المشروع​

POST /v1/projects/:id/archive

إلغاء أرشفة المشروع​

POST /v1/projects/:id/unarchive