विश्लेषण API

कोड विश्लेषण और AI-संचालित अंतर्दृष्टि के लिए एंडपॉइंट्स।

सिमेंटिक खोज

प्राकृतिक भाषा का उपयोग करके कोड खोजें।

POST /v1/projects/:id/search

अनुरोध बॉडी:

{
  "query": "उपयोगकर्ता प्रमाणीकरण प्रवाह",
  "limit": 10
}

प्रतिक्रिया:

{
  "success": true,
  "results": [
    {
      "filePath": "src/auth/login.ts",
      "lineStart": 45,
      "lineEnd": 78,
      "content": "async function authenticate(email, password) {...}",
      "score": 0.92,
      "context": "LoginService - उपयोगकर्ता प्रमाणीकरण संभालता है"
    }
  ]
}

AI सहायक से पूछें

अपने कोडबेस के बारे में प्रश्न पूछें।

POST /v1/projects/:id/ask

अनुरोध बॉडी:

{
  "question": "प्रमाणीकरण प्रणाली कैसे काम करती है?",
  "language": "hi"
}

प्रतिक्रिया:

{
  "success": true,
  "answer": "प्रमाणीकरण प्रणाली JWT टोकन का उपयोग करती है...",
  "references": [
    {
      "filePath": "src/auth/login.ts",
      "description": "मुख्य प्रमाणीकरण लॉजिक"
    }
  ]
}

प्रभाव विश्लेषण

फ़ाइल में परिवर्तनों के प्रभाव का विश्लेषण करें।

POST /v1/projects/:id/analyze

अनुरोध बॉडी:

{
  "path": "src/services/user.ts"
}

प्रतिक्रिया:

{
  "success": true,
  "impact": {
    "directDependencies": [
      "src/utils/crypto.ts",
      "src/db/models/user.ts"
    ],
    "dependents": [
      "src/controllers/auth.ts",
      "src/controllers/profile.ts"
    ],
    "affectedTests": [
      "tests/user.test.ts"
    ],
    "riskLevel": "medium",
    "recommendation": "परिवर्तनों के लिए auth और प्रोफ़ाइल फ्लो की टेस्टिंग आवश्यक है"
  }
}

कोड मेट्रिक्स

कोड गुणवत्ता मेट्रिक्स प्राप्त करें।

GET /v1/projects/:id/metrics

क्वेरी पैरामीटर्स:

पैरामीटर	प्रकार	विवरण
path	string	पथ द्वारा फ़िल्टर करें (वैकल्पिक)

प्रतिक्रिया:

{
  "success": true,
  "metrics": {
    "summary": {
      "totalFiles": 234,
      "totalLines": 15420,
      "avgComplexity": 4.2,
      "maxComplexity": 18,
      "duplicatePercentage": 3.1
    },
    "byFile": [
      {
        "path": "src/services/complex.ts",
        "lines": 450,
        "complexity": 18,
        "maintainability": 62
      }
    ]
  }
}

सुरक्षा स्कैन

सुरक्षा भेद्यता स्कैन परिणाम प्राप्त करें।

GET /v1/projects/:id/security

प्रतिक्रिया:

{
  "success": true,
  "scan": {
    "status": "completed",
    "scannedAt": "2024-01-15T10:30:00Z",
    "summary": {
      "high": 2,
      "medium": 5,
      "low": 8
    },
    "issues": [
      {
        "severity": "high",
        "type": "sql-injection",
        "file": "src/db/query.ts",
        "line": 34,
        "description": "संभावित SQL इंजेक्शन भेद्यता",
        "recommendation": "पैरामीटराइज्ड क्वेरी का उपयोग करें"
      }
    ]
  }
}

डेड कोड डिटेक्शन

अप्रयुक्त कोड खोजें।

GET /v1/projects/:id/dead-code

प्रतिक्रिया:

{
  "success": true,
  "deadCode": {
    "unusedExports": [
      {
        "file": "src/utils/helpers.ts",
        "name": "formatDate",
        "line": 45,
        "type": "function"
      }
    ],
    "unusedFiles": [
      "src/legacy/old-service.ts"
    ],
    "estimatedLines": 234
  }
}

कोड डुप्लीकेशन

डुप्लीकेट कोड ब्लॉक खोजें।

GET /v1/projects/:id/duplication

प्रतिक्रिया:

{
  "success": true,
  "duplication": {
    "percentage": 3.1,
    "duplicates": [
      {
        "lines": 15,
        "occurrences": [
          { "file": "src/api/users.ts", "start": 45, "end": 60 },
          { "file": "src/api/products.ts", "start": 32, "end": 47 }
        ]
      }
    ]
  }
}