📚 توثيق API
دليل شامل لكل المسارات المتاحة في فاصلة النص (279 endpoint).
🔐 المصادقة
/api/auth/loginتسجيل دخول بإيميل + كلمة سرّ
/api/auth/registerتسجيل مستخدم جديد
/api/auth/logoutتسجيل خروج
👤 المستخدمون
/api/profile/updateتحديث الملفّ الشخصي
/api/profile/consultantملفّ مستشار حسب userId
📋 الاستشارات
/api/consultations/listقائمة استشاراتي
/api/consultations/createإنشاء استشارة جديدة
/api/consultations/[id]تفاصيل استشارة
/api/consultations/[id]/messagesإرسال رسالة
/api/consultations/[id]/uploadرفع مرفق
/api/consultations/[id]/voiceرفع رسالة صوتيّة
/api/consultations/[id]/follow-upمتابعة استشارة
/api/consultations/acceptقبول استشارة (مستشار)
/api/consultations/assignإسناد استشارة
👨⚖️ المستشارون
/api/consultants/listقائمة المستشارين
/api/consultants/[id]ملفّ مستشار
/api/consultants/available-nowالمتاحون الآن
🤖 الذكاء الاصطناعي
/api/ai/triageتحليل ذكي للقضيّة
/api/ai/smart-matchمطابقة بالمستشار الأنسب
/api/ai/chatمحادثة مع الـ AI Chatbot
/api/ai/legal-researchبحث قانوني
/api/ai/mediatorوساطة AI
/api/ai/petitionصياغة مذكّرة
/api/chatbotRate-LimitedChatbot العامّ
/api/contract-analyzerAuth+Rate-Limitedتحليل العقود
💰 المحفظة
/api/walletرصيد المحفظة
/api/wallet/topupشحن المحفظة
/api/wallet/topup/bankشحن بنكي
/api/wallet/withdrawطلب سحب
/api/wallet/transactionsسجلّ المعاملات
💳 المدفوعات
/api/payments/initiateMoyasarبدء عمليّة دفع
/api/payments/verifyتأكيد الدفع
/api/payments/saveحفظ paymentId قبل الـ redirect
/api/payments/apple-pay/validateتحقّق Apple Pay
/api/payments/apple-pay/chargeدفع Apple Pay
/api/payments/mada/chargeدفع Mada
/api/payments/stc-pay/initبدء STC Pay
/api/payments/stc-pay/confirmتأكيد STC Pay
/api/payments/bnpl/tabbyتابي
/api/payments/bnpl/tamaraتمارا
/api/payments/pay-linkOptionalرابط دفع سريع
/api/payments/webhook/moyasarHMACMoyasar Webhook
/api/payments/tamara-webhookHMACTamara Webhook
🔔 الإشعارات
/api/notifications/listقائمة الإشعارات
/api/notifications/readتحديد كمقروء
/api/realtime/streamSSESSE — أحداث فوريّة
📞 المكالمات الفوريّة
/api/instant-callsطلب مكالمة فوريّة
/api/instant-calls/[id]قبول/رفض/إنهاء المكالمة
💸 Escrow & العقود الذكيّة
/api/escrowإنشاء Escrow بإنجازات
/api/escrow/milestones/[id]/approveاعتماد إنجاز
/api/smart-contractsإنشاء عقد ذكي
/api/smart-contracts/[id]/signتوقيع عقد
🛠️ الخدمات
/api/services/[id]/claimمستشار يقبل الخدمة
/api/services/[id]/deliverتسليم الخدمة
/api/services/[id]/acceptNewالعميل يقبل التسليم + تحرير المبلغ
/api/services/[id]/payدفع الخدمة
🔗 Webhooks (داخلي)
/api/webhooksتسجيل webhook
/api/webhooksقائمة الـ webhooks
⏰ Cron Jobs
/api/cron/expire-plansCRON_SECRETكل 10 دقائق
/api/cron/scheduled-messagesCRON_SECRETكل 5 دقائق
/api/cron/cleanup-cacheCRON_SECRETيوميّاً 3 ص