API अवलोकन
ArchiCore REST API आपको अपने वर्कफ़्लो में आर्किटेक्चर विश्लेषण को एकीकृत करने की अनुमति देता है।
बेस URL
https://api.archicore.io/api/v1
प्रमाणीकरण
सभी API अनुरोधों के लिए Bearer टोकन का उपयोग करके प्रमाणीकरण आवश्यक है:
curl -H "Authorization: Bearer आपकी_API_कुंजी" \
https://api.archicore.io/api/v1/projects
API कुंजी प्राप्त करने के विवरण के लिए प्रमाणीकरण देखें।
प्रतिक्रिया प्रारूप
सभी प्रतिक्रियाएं JSON हैं:
{
"success": true,
"data": { ... }
}
त्रुटि प्रतिक्रियाएं:
{
"success": false,
"error": "त्रुटि संदेश",
"code": "त्रुटि_कोड"
}
HTTP स्थिति कोड
| कोड | विवरण |
|---|---|
200 | सफलता |
201 | बनाया गया |
400 | गलत अनुरोध - अमान्य पैरामीटर |
401 | अनधिकृत - अमान्य या गायब टोकन |
403 | निषिद्ध - अपर्याप्त अनुमतियां |
404 | नहीं मिला |
429 | बहुत अधिक अनुरोध - दर सीमा पार |
500 | आंतरिक सर्वर त्रुटि |
दर सीमाएं
| स्तर | अनुरोध/दिन | अनुरोध/मिनट |
|---|---|---|
| मुफ्त | 100 | 10 |
| Pro | 10,000 | 100 |
| Enterprise | असीमित | 1,000 |
दर सीमा हेडर सभी प्रतिक्रियाओं में शामिल हैं:
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1640000000
एंडपॉइंट सारांश
प्रोजेक्ट
| मेथड | एंडपॉइंट | विवरण |
|---|---|---|
GET | /projects | सभी प्रोजेक्ट सूचीबद्ध करें |
POST | /projects | प्रोजेक्ट बनाएं |
GET | /projects/:id | प्रोजेक्ट विवरण प्राप्त करें |
DELETE | /projects/:id | प्रोजेक्ट हटाएं |
POST | /projects/:id/index | इंडेक्सिंग शुरू करें |
विश्लेषण
| मेथड | एंडपॉइंट | विवरण |
|---|---|---|
POST | /projects/:id/search | सिमेंटिक खोज |
POST | /projects/:id/ask | AI असिस्टेंट से पूछें |
GET | /projects/:id/metrics | कोड मेट्रिक्स प्राप्त करें |
GET | /projects/:id/security | सुरक्षा स्कैन परिणाम |
POST | /projects/:id/analyze | प्रभाव विश्लेषण |
Webhooks
| मेथड | एंडपॉइंट | विवरण |
|---|---|---|
GET | /webhooks | Webhooks सूचीबद्ध करें |
POST | /webhooks | Webhook बनाएं |
DELETE | /webhooks/:id | Webhook हटाएं |
SDK
आधिकारिक SDK उपलब्ध हैं:
- JavaScript/TypeScript:
npm install @archicore/sdk - Python:
pip install archicore
त्वरित उदाहरण
import { ArchiCore } from '@archicore/sdk';
const client = new ArchiCore({ apiKey: 'आपकी_API_कुंजी' });
// कोड खोजें
const results = await client.projects.search('project-id', {
query: 'प्रमाणीकरण लॉजिक'
});
// AI से पूछें
const answer = await client.projects.ask('project-id', {
question: 'प्रमाणीकरण प्रणाली कैसे काम करती है?'
});