نظرة عامة على واجهة API

توفر Memvera واجهة REST كاملة — كل ما تفعله بوابات الموظفين والأعضاء والمدربين متاح للتكامل: تسجيل الأعضاء، بيع العضويات، حجز الحصص وإلغاؤها، قراءة التقارير، وغير ذلك. تُعرض النهايات مجمّعة حسب الوحدة في مرجع API.

الرابط الأساسي

https://api.memvera.com/api

المصادقة

كل طلب (عدا مجموعة Public) يرسل رمز Bearer:

Authorization: Bearer <token>
X-Brand: <brand code>

• الرموز تصدر لكل مستخدم. للتكاملات بين الخوادم، اطلب من مدير النادي إنشاء رمز موصل محدود الصلاحيات من الإعدادات ← تكامل MCP — هذه الرموز غير مرتبطة بجلسة تسجيل دخول.
• X-Brand يحدد النادي (المستأجر). المستخدمون المرتبطون بعلامة يُقفلون عليها من الخادم بغض النظر عن الترويسة.
• الصلاحيات تُفرض على كل نهاية — الرمز يصل فقط لما تسمح به صلاحياته.

الاصطلاحات

الاصطلاح	التفاصيل
المبالغ	أعداد صحيحة بالوحدات الصغرى (هللات): amount_minor: 15000 = 150.00 ريال
التواريخ	نصوص ISO 8601 (2026-08-04T10:30:00+03:00)؛ المنطقة الزمنية Asia/Riyadh
المعرفات	ULID (نص من 26 حرفًا)
الأخطاء	JSON قياسي: 422 للتحقق (خريطة errors)، 401 غير مصادق، 403 ممنوع، 404 غير موجود
الترقيم	معامل page؛ الاستجابات تحمل total / last_page

السحب أم الدفع؟

• السحب: استدعِ REST API وفق جدولك.
• الدفع: اشترك في الويب هوك — ترسل Memvera أحداثًا موقّعة (بيع عضوية، إلغاء حجز، تسوية دفعة…) إلى نظامك خلال دقيقة من حدوثها. لتكاملات ERP وأنظمة التواصل، الويب هوك عادة نقطة البداية الأفضل.