English تسجيل الدخول اطلب عرضًا توضيحيًا

واجهة برمجية مفتوحة

اربط أنظمتك بمحجوز.

واجهة برمجية مفتوحة وWebhooks: اقرأ الطلبات والعملاء والخدمات والموظفين والفروع، وأنشئ الطلبات والعملاء من أنظمتك.

افتح مرجع APIاحصل على بيانات الاعتماد

Mahjoz Open API

الرابط الأساسي
https://api.mahjoz.io/api/open/v1
المصادقة
OAuth2 Client Credentials
الأحداث
Webhooks للطلبات، موقّعة بـ HMAC-SHA256
حد الاستدعاءات
60 استدعاءً في الدقيقة لكل عميل API
الإتاحة
باقة الأعمال

ما يمكنك بناؤه بالواجهة البرمجية.

  • أنشئ طلبات من نظامك

    تحقق من الأوقات المتاحة ثم أنشئ الطلب في محجوز من موقعك أو تطبيقك.

  • زامن العملاء

    اقرأ العملاء وابحث برقم الجوال، وأضف عملاء جُددًا من أنظمتك.

  • استقبل أحداث الطلبات

    يصلك إشعار فوري عند إنشاء طلب أو تغيير حالته أو إصدار فاتورته أو قبول دفعته.

  • اعرض خدماتك وفريقك

    اقرأ العناصر والتصنيفات والموظفين والفروع لعرضها في واجهاتك.

طريقتان للربط: بالبرمجة أو بالمحادثة.

  • باقة الأعمال

    Open API وWebhooks

    للمطورين وفرق التقنية: ربط محجوز بأنظمتك عبر OAuth وصلاحيات محددة لكل عميل API.

    قارن الباقات
  • باقتا النمو والأعمال

    ربط Claude وChatGPT

    لأصحاب الأنشطة: أدِر نشاطك بالمحادثة من داخل Claude أو ChatGPT عبر بروتوكول MCP، بلا برمجة.

    عن المساعد الذكي

ابدأ في ثلاث خطوات.

المصادقة عبر OAuth2 Client Credentials.

  1. 1

    أنشئ عميل API

    من لوحة التحكم: الإعدادات ثم الربط البرمجي. يظهر لك client_id وclient_secret، ولا يظهر السر إلا مرة واحدة، فاحفظه فورًا.

    إعدادات الواجهة البرمجية
  2. 2

    احصل على رمز الوصول

    أرسل بيانات الاعتماد بنوع المنح client_credentials لتحصل على رمز Bearer.

    POST /oauth/token
  3. 3

    استخدم الرمز

    أضف الرمز في ترويسة كل استدعاء.

    Authorization: Bearer <access_token>

صلاحيات دقيقة لكل عميل API.

لا يحصل عميل API إلا على الصلاحيات التي يحتاجها.

صلاحيات الواجهة البرمجية
الموردالصلاحياتماذا تتيح
الطلباتorders:read orders:writeقراءة الطلبات، وإنشاؤها، والتحقق من التوفر
العملاءcustomers:read customers:writeقراءة العملاء والبحث برقم الجوال، وإضافة عملاء
العناصرitems:readقراءة الخدمات والمنتجات
الموظفونstaff:readقراءة الموظفين وخدماتهم وساعات عملهم
الفروع والتصنيفاتbranches:read categories:readقراءة الفروع والتصنيفات
طرق الدفعpayment_methods:read payment_methods:writeقراءة طرق الدفع وإنشاؤها
العمليات الماليةtransactions:read transactions:writeقراءة العمليات وتسجيل دفعات الطلبات
Webhookswebhooks:read webhooks:writeإدارة اشتراكات Webhooks

أما الصلاحية * فتمنح كل الصلاحيات. والتفاصيل الكاملة لكل نقطة نهاية، مع أمثلة الطلب والاستجابة، في المرجع.

افتح مرجع API

الحدود والأحداث والأخطاء.

كل الأخطاء بالشكل نفسه: حقل error وحقل message.

  • حد الاستدعاءات

    60 / دقيقة

    لكل عميل API. عند التجاوز يصلك الرمز 429 مع ترويسة Retry-After.

  • Webhooks

    3 لكل حساب

    موقّعة بـ HMAC-SHA256 في ترويسة Signature، مع 3 محاولات إعادة عند الفشل.

  • صلاحية الرمز

    سنة

    expires_in: 31536000 ثانية.

أحداث الطلبات

  • order.created
  • order.updated
  • order.deleted
  • order.status_changed
  • order.invoice_created
  • order.payment_accepted

معالجة الأخطاء

رموز الأخطاء
الحالةرمز الخطأالمعنى
401authentication_failedالرمز مفقود أو غير صالح أو منتهي الصلاحية
403insufficient_scopeالرمز لا يملك الصلاحية المطلوبة
403feature_disabledالواجهة البرمجية غير متاحة في الباقة الحالية
422validation_errorبيانات الطلب غير صحيحة
422timeslot_unavailableالوقت المطلوب غير متاح
429—تجاوزت حد الاستدعاءات
502availability_check_failedتعذّر الوصول لخدمة الحجوزات

دعم المطورين.

تحتاج مساعدة في الربط؟

إذا كنت تستخدم محجوز لنشاطك، فتواصل مع فريق الدعم.

مركز المساعدة

بِع أي شيء.شغّل كل شيء.نمِّ كل عميل.

  1. الموقع الإلكترونيلعملائك

  2. لوحة التحكملإدارتك

  3. تطبيق الموظفينلفريقك

  4. الكاشيرلفريقك

  5. تطبيق العملاءلعملائك

شغّل نشاطك كله على منصة واحدة. تحدّث مع فريق المبيعات، ونعرض لك محجوز كما سيعمل في نشاطك.

  • عرض توضيحي مجاني
  • بدون التزام
  • بدون عمولة على مبيعاتك
اطلب عرضًا توضيحيًا تواصل عبر واتساب

+966 58 150 4066 · info@mahjoz.io