نقاط REST

جميع نقاط النهاية تستخدم عنوان URL الأساسي https://api.hashee.ai. المصادقة عبر Authorization: Bearer {token} ما لم تكن مُعلّمة كعامة.

المصادقة

الطريقة	المسار	المصادقة	الوصف
POST	/auth/register	عام	تسجيل حساب جديد
POST	/auth/login	عام	تسجيل الدخول بكلمة المرور
POST	/auth/login-code	عام	تسجيل الدخول برمز التحقق
POST	/auth/send-code	عام	إرسال رمز التحقق
POST	/auth/refresh	Cookie	تحديث رمز الوصول
POST	/auth/logout	JWT	تسجيل خروج الجلسة الحالية
POST	/auth/reset-password	عام	إعادة تعيين كلمة مرور الحساب
POST	/auth/change-password	JWT	تغيير كلمة مرور الحساب
POST	/auth/change-protection-password	JWT	تغيير كلمة مرور الحماية
GET	/auth/me	JWT	الحصول على ملف المستخدم الحالي
POST	/auth/passkey/begin	عام	بدء تسجيل الدخول بـ Passkey
POST	/auth/passkey/complete	عام	إكمال تسجيل الدخول بـ Passkey
POST	/auth/passkey/register/begin	JWT	بدء تسجيل Passkey
POST	/auth/passkey/register/complete	JWT	إكمال تسجيل Passkey
GET	/auth/passkey/credentials	JWT	قائمة بيانات اعتماد Passkey
PATCH	/auth/passkey/credentials/:id	JWT	إعادة تسمية Passkey
DELETE	/auth/passkey/credentials/:id	JWT	حذف Passkey

المستخدمون

الطريقة	المسار	المصادقة	الوصف
GET	/users/me	JWT	الحصول على الملف الشخصي
PATCH	/users/me	JWT	تحديث الملف الشخصي
GET	/users/:id	JWT	الحصول على مستخدم بالمعرّف
GET	/users/search	JWT	البحث عن مستخدمين
DELETE	/users/me	JWT	إلغاء تفعيل وحذف الحساب
PATCH	/users/contacts/:id	JWT	تعيين اسم ملاحظة جهة الاتصال

مفاتيح E2EE

الطريقة	المسار	المصادقة	الوصف
POST	/keys/backup	JWT	رفع نسخة احتياطية مشفرة للمفاتيح
GET	/keys/backup	JWT	تنزيل النسخة الاحتياطية
PUT	/keys/backup	JWT	تحديث النسخة الاحتياطية
GET	/keys/users/:id/devices	JWT	الحصول على المفاتيح العامة لأجهزة المستخدم
GET	/keys/agents/:id	JWT	الحصول على المفتاح العام للوكيل
GET	/keys/groups/:id	JWT	الحصول على مفتاح تشفير المجموعة
POST	/keys/groups/:id/rotate	JWT	تدوير مفتاح المجموعة
POST	/keys/rotation/request	JWT	طلب تدوير مفتاح H2H
POST	/keys/rotation/confirm	JWT	تأكيد تدوير مفتاح H2H
POST	/agents/:id/keys/register	وكيل	تسجيل المفتاح العام للوكيل

المحادثات

الطريقة	المسار	المصادقة	الوصف
GET	/conversations	JWT	قائمة المحادثات
PATCH	/conversations/:id	JWT	تحديث إعدادات المحادثة
DELETE	/conversations/:id	JWT	إخفاء المحادثة
POST	/conversations/:id/read	JWT	تحديد كمقروء
GET	/conversations/:id/messages	JWT	الحصول على سجل الرسائل
GET	/conversations/:id/media	JWT	الحصول على الوسائط في المحادثة
PUT	/conversations/:id/draft	JWT	حفظ مسودة
GET	/conversations/:id/draft	JWT	الحصول على المسودة
DELETE	/conversations/:id/draft	JWT	حذف المسودة

الرسائل

الطريقة	المسار	المصادقة	الوصف
POST	/conversations/:id/messages	JWT	إرسال رسالة
POST	/messages/:id/recall	JWT	استدعاء رسالة
POST	/messages/:id/reactions	JWT	إضافة/إزالة تفاعل
GET	/messages/:id/reactions	JWT	الحصول على قائمة التفاعلات
POST	/messages/forward	JWT	إعادة توجيه الرسائل (أقصى 10 أهداف)
PATCH	/messages/:id/artifact	وكيل	تحديث artifact

المجموعات

الطريقة	المسار	المصادقة	الوصف
POST	/groups	JWT	إنشاء مجموعة
GET	/groups/:id	JWT	تفاصيل المجموعة
PATCH	/groups/:id	JWT	تحديث إعدادات المجموعة
DELETE	/groups/:id	JWT	حذف المجموعة
GET	/groups/:id/members	JWT	قائمة الأعضاء
POST	/groups/:id/members	JWT	إضافة أعضاء
DELETE	/groups/:gid/members/:mid	JWT	إزالة عضو
PATCH	/groups/:gid/members/:mid	JWT	تحديث دور العضو
PATCH	/groups/:gid/members/me	JWT	تحديث ملفك في المجموعة
POST	/groups/:gid/leave	JWT	مغادرة المجموعة
POST	/groups/:id/transfer	JWT	نقل الملكية
POST	/groups/:gid/join	JWT	الانضمام عبر رمز المشاركة
GET	/groups/:gid/join-requests	JWT	قائمة طلبات الانضمام المعلّقة
POST	/groups/:gid/join-requests/:uid/approve	JWT	الموافقة على طلب الانضمام
POST	/groups/:gid/join-requests/:uid/reject	JWT	رفض طلب الانضمام
POST	/groups/:id/pinned-messages	JWT	تثبيت رسالة
GET	/groups/:id/pinned-messages	JWT	قائمة الرسائل المثبتة
DELETE	/groups/:gid/pinned-messages/:mid	JWT	إلغاء تثبيت رسالة
POST	/groups/:gid/members/:mid/mute	JWT	كتم عضو
POST	/groups/:id/agent-instances	JWT	إضافة وكيل للمجموعة
DELETE	/groups/:gid/agent-instances/:iid	JWT	إزالة وكيل من المجموعة

إدارة الوكيل (المنشئ)

الطريقة	المسار	المصادقة	الوصف
POST	/agents	JWT	إنشاء وكيل
GET	/agents	JWT	قائمة وكلائك
GET	/agents/:id	JWT	تفاصيل الوكيل
PATCH	/agents/:id	JWT	تحديث ملف الوكيل
DELETE	/agents/:id	JWT	حذف الوكيل
GET	/agents/check-id	JWT	التحقق من توفر المعرّف المخصص
GET	/agents/:id/token	JWT	الحصول على رمز الوكيل
POST	/agents/:id/token/regenerate	JWT	إعادة إنشاء الرمز
GET	/agents/:id/commands	JWT	الحصول على أوامر الشرطة المائلة
POST	/agents/:id/commands	JWT	تحديث أوامر الشرطة المائلة
GET	/agents/:id/invite-codes	JWT	قائمة أكواد الدعوة
POST	/agents/:id/invite-codes	JWT	إنشاء كود دعوة
PATCH	/invite-codes/:id	JWT	تحديث كود الدعوة
GET	/agents/:id/requests	JWT	قائمة طلبات المستخدمين
POST	/agents/:id/requests/:rid/approve	JWT	الموافقة على طلب مستخدم
POST	/agents/:id/users/:uid/suspend	JWT	تعليق مستخدم
POST	/agents/:id/users/:uid/restore	JWT	استعادة مستخدم
GET	/agents/:id/governance	JWT	الحصول على حالة الحوكمة

نقاط الوكيل (مصادقة رمز الوكيل)

الطريقة	المسار	المصادقة	الوصف
POST	/agents/:id/conversations/:cid/messages	وكيل	إرسال رسالة
POST	/agents/:id/typing	وكيل	إرسال مؤشر كتابة
GET	/agents/:id/messages/poll	وكيل	استطلاع الرسائل
GET	/agents/:id/conversations	وكيل	قائمة المحادثات
GET	/agents/:id/conversations/:cid/messages	وكيل	الحصول على رسائل المحادثة
POST	/agents/:id/files	وكيل	طلب URL رفع ملف
PUT	/agents/:id/files/:uploadId/upload	وكيل	رفع ملف ثنائي

الملفات

الطريقة	المسار	المصادقة	الوصف
POST	/files/presign	JWT	طلب URL رفع موقّع مسبقاً
PUT	/files/:upload_id/upload	JWT	رفع ملف ثنائي
POST	/files/confirm	JWT	تأكيد الرفع بـ SHA-256

أخرى

الطريقة	المسار	المصادقة	الوصف
GET	/health	عام	فحص الصحة
GET	/search	JWT	بحث في الممثلين والـ artifacts
POST	/reports	JWT	الإبلاغ عن وكيل
POST	/share/friend	JWT	إنشاء رابط مشاركة صديق
POST	/share/agent	JWT	إنشاء رابط مشاركة وكيل
POST	/share/group	JWT	إنشاء رابط مشاركة مجموعة
GET	/share/*	عام	حل رابط المشاركة

الخطوات التالية

• أحداث WebSocket — مرجع الأحداث في الوقت الحقيقي
• المصادقة — تفاصيل تدفق المصادقة
• أكواد الأخطاء — جدول أكواد الأخطاء