مرجع API

REST API for missions, Brain queries, HIT, and integrations. E2E encrypted.

نظرة عامة

API مبني على REST، يعيد JSON، ومشفر E2E. جميع نقاط النهاية تتطلب مصادقة عبر Keycloak SSO (رمز bearer OAuth2). يتم فرض عزل المستأجرين على جميع المستويات.

المصادقة

جميع طلبات API تتطلب رمز Bearer من Keycloak. الرمز له نطاق المستأجر وينتهي بعد ساعة واحدة. يتم توفير رموز التحديث للجلسات الطويلة.

نقاط النهاية الرئيسية

POST /api/missions — إرسال مهمة جديدة. GET /api/missions/:id — الحصول على حالة المهمة. GET /api/brain/query — استعلام Brain/RAG. GET /api/hit — قائمة موافقات HIT المعلقة. POST /api/hit/:id/approve — الموافقة على عنصر HIT.

أمثلة الكود

راجع مرجع API لأمثلة curl وPython وJavaScript. يسمح بروتوكول MCP باكتشاف الأدوات وتنفيذها مباشرة من أي عميل متوافق مع MCP.

hạn الحدود

الحدود الزمنية هي حسب المستأجر ومستوى الخدمة. البدء: 100 طلب/دقيقة. الأعمال: 500 طلب/دقيقة. المحترف: 2000 طلب/دقيقة. المؤسسة: مخصصة. جميع الحدود يمكن أن تتجاوزها 2 مرة لمدة 10 ثوانٍ.