عنوان الأساس
| البيئة | العنوان |
|---|---|
| الإنتاج | https://api.commandagi.com |
البادئة /v1 اختيارية: /v1/threads و/threads هما المسار نفسه.
المصادقة
أرسل مفتاح API كرمز حامل (bearer token):
curl https://api.commandagi.com/v1/me \
-H "Authorization: Bearer cagi_YOUR_KEY"- تبدأ مفاتيح API بـ
cagi_متبوعة بـ 64 حرفاً سداسي عشري، وتُخزَّن كتجزئات فقط. - أنشئ المفاتيح وألغِها في منضدة العمل من مفاتيح API في قائمة الحساب، أو عبر
GET/POST /me/api-keysوDELETE /me/api-keys/:keyId. يحصل الوكلاء على مفاتيحهم عبر/agents/:id/keys. - لتعمل كأحد مؤسساتك، أضف
x-cagi-account: <account id>. - تقبل نقاط WebDAV وGit المفتاح نفسه ككلمة مرور مصادقة Basic.
مفتاح الوكيل يعمل داخل حساب مالكه، لكنه لا يستطيع أبداً تغيير الصلاحيات: المسارات التي تنشئ تفويضات، أو تضع أجهزة، أو تغيّر المالكين أو الإعدادات أو مفاتيح التوقيع، ترد عليه بـ 403 human_principal_required.
حفظ الملفات دون فقد العمل
تحدد الكتابة النسخة التي تستبدلها: أرسل If-Match: "<sha256>" بالتجزئة التي قرأتها، أو If-None-Match: * لإنشاء ملف يجب ألا يكون موجوداً. إذا تغيّر الملف في الأثناء، ترد الواجهة بـ 412 ولا يُكتب فوقه شيء.
النقاط
| المجموعة | نقاط النهاية |
|---|---|
| الحسابات | GET POST /accounts · GET /accounts/:id · GET PUT PATCH /accounts/:id/settings · GET /accounts/me/chain |
| التفويضات الدائمة | GET POST /accounts/:id/standing-grants · DELETE /standing-grants/:id · GET /standing-grants/held |
| مفاتيح التوقيع | GET /accounts/:id/signing-key · POST /accounts/:id/signing-key/rotate |
| المضيفون | GET /accounts/:id/hosts · POST /hosts/:hostId/call |
| الملفات | GET /drive · POST /drive/upload · GET PUT /drive/:id/content · PATCH DELETE /drive/:id · POST /drive/folders |
| الوكلاء | GET POST /agents · GET PATCH DELETE /agents/:id · GET PUT /default-agents |
| المحادثات | GET /me/threads · POST /threads · GET PATCH DELETE /threads/:id · GET /threads/:id/events · POST /threads/:id/inject |
| التداول | GET /trading/venues · POST /trading/order · POST /trading/account · POST /trading/cancel |
| النماذج | GET /models · GET /models/catalog · GET /models/families |
| MCP | POST /mcp — راجع SDK وMCP |
| الحالة | GET /health |
النماذج
GET /models يسرد النماذج التي تستطيع استخدامها، بصيغة { "models": [ … ] }؛ صفِّها بـ ?useCase=. النموذج الأول من إنتاجنا هو commandagi/CommandAGI-000. تُعرض النماذج من مزودين آخرين بمعرّفاتها الخاصة، ويمكنك استخدام مفتاح مزودك الخاص لكل حساب أو مؤسسة.
لا توجد نقطة تماثل OpenAI لإكمال الدردشة؛ استخدم المحادثات.
الأخطاء
رمز HTTP يوضح ما الخطأ: 401 بلا مفتاح صالح، و403 حين لا يحق للجهة الفاعلة فعل هذا، و404 حين لا يوجد الشيء أو ليس من حقك رؤيته، و412 حين تغيّر ملف تحت يدك.