منصة الـ API والمطوّرون
واجهات برمجية (API) كاملة، وأحداث فورية عبر Webhooks، وأدوات تطوير عربية لربط ProBase بأنظمتك الداخلية: من نظام تخطيط الموارد (ERP) إلى المحاسبة والمتاجر الإلكترونية.
ابدأ من وثائق الـ API، أنشئ مفتاحك الأول في بيئة الاختبار، أو احجز جلسة مع فريق المطوّرين لتصميم تكامل يناسب أنظمتك.منصّة API مفتوحة بُنيت ليُبنى عليها
ProBase ليست صندوقاً مغلقاً. كل ما تفعله المنصّة من الواجهة الرسومية متاح أيضاً برمجياً عبر واجهات REST API منظّمة وواضحة. سواء أردت إنشاء صفقة من نظامك الداخلي، أو دفع رسالة واتساب من تطبيقك الخاص، أو سحب بيانات العملاء إلى لوحة تحكم تخصّك، فإن المنصّة مصمّمة لتكون طبقة العمليات التي تربط فرق المبيعات وخدمة العملاء ببقية أنظمتك. الهدف بسيط: ألّا تضطر أبداً لإدخال البيانات مرتين أو لبناء جسور هشّة بين أدواتك.
- واجهات REST API تتبع معايير HTTP المعروفة (GET/POST/PATCH/DELETE) وترجع استجابات JSON متّسقة
- تغطية للكيانات الأساسية: العملاء، المحادثات، الرسائل، الصفقات، الفواتير، والمنتجات
- أكواد أخطاء واضحة ورسائل وصفية تسهّل تشخيص المشكلات أثناء التطوير
- ترقيم الإصدارات (versioning) للحفاظ على استقرار تكاملاتك عند تطوّر المنصّة
مصادقة بمفاتيح API تحت سيطرتك
تتم المصادقة عبر مفاتيح API تُنشئها وتديرها بنفسك من لوحة التحكم، وتُرسَل في ترويسة الطلب (Authorization Header). يمكنك إصدار أكثر من مفتاح للفصل بين الأنظمة والبيئات، وإلغاء أي مفتاح فوراً عند الحاجة دون التأثير على بقية تكاملاتك. نوصي بحصر صلاحيات كل مفتاح على ما يحتاجه فعلاً، والاحتفاظ بالمفاتيح في خزائن أسرار آمنة وليس داخل الشيفرة المصدرية.
- إنشاء وإلغاء المفاتيح فوراً من واجهة الإدارة دون انتظار
- فصل مفاتيح بيئة الاختبار عن بيئة الإنتاج لتفادي الأخطاء العرضية
- إمكانية ربط كل مفتاح بنظام محدّد لتتبّع الاستخدام والمسؤولية
- تدوير المفاتيح (rotation) بسلاسة دون انقطاع الخدمة
Webhooks للأحداث: استجِب لحظةً بلحظة
بدل أن تسأل المنصّة باستمرار عمّا إذا حدث جديد، تُرسل إليك ProBase الحدث فور وقوعه عبر Webhooks. عند وصول رسالة جديدة، أو تغيّر حالة صفقة، أو إصدار فاتورة، يصلك طلب HTTP إلى الرابط الذي تحدّده محمّلاً ببيانات الحدث. هذا يجعل تكاملاتك لحظية بحق: حدّث نظامك الداخلي، أطلق سير عمل، أو أبلغ فريقاً آخر في الثانية نفسها التي يقع فيها الحدث.
- أحداث الرسائل: استقبال رسالة واتساب جديدة أو رد من عميل
- أحداث الصفقات: إنشاء صفقة، انتقالها بين مراحل القمع، أو إغلاقها
- أحداث الفواتير: إصدار فاتورة، تحديثها، أو تسجيل دفعة
- توقيع مشفّر لكل حمولة (payload) للتحقق من أن الحدث صادر فعلاً من ProBase
- إعادة المحاولة التلقائية عند تعذّر وصول الحدث إلى خادمك مؤقتاً
حدود معدّل سخيّة وبيئة اختبار كاملة
صمّمنا حدود المعدّل (Rate Limits) لتكون مريحة للاستخدام الواقعي، بحيث لا تصطدم بها التكاملات السليمة في تشغيلها اليومي، مع حماية المنصّة من الاستخدام المفرط. وقبل أن تلمس بيانات الإنتاج، تمنحك بيئة الاختبار (Sandbox) مساحة معزولة بالكامل لتجربة كل نداء API ومحاكاة الأحداث وتدفّقات Webhooks دون أي أثر على عملائك الحقيقيين أو محادثاتهم.
- حدود معدّل معلنة بوضوح مع ترويسات تبيّن رصيدك المتبقّي في كل استجابة
- بيئة اختبار منفصلة ببيانات وهمية لا تمسّ الإنتاج
- محاكاة أحداث الرسائل والصفقات والفواتير لاختبار Webhooks قبل الإطلاق
- إمكانية بناء واختبار التكامل بالكامل قبل تفعيله على حساب عملك الفعلي
اربط أنظمتك الداخلية: ERP والمحاسبة والمتاجر
أكثر تكاملات ProBase قيمةً هي تلك التي تجعلها تتحدّث مع الأنظمة التي تدير بها أعمالك أصلاً. اربط الصفقات المغلقة بنظام تخطيط الموارد (ERP) لإطلاق أوامر التوريد، أو زامن الفواتير مع نظامك المحاسبي، أو حدّث حالة الطلب في متجرك الإلكتروني ليصل العميل إشعار واتساب فوري. تتيح الواجهات البرمجية وWebhooks معاً بناء هذا التزامن في الاتجاهين دون عمل يدوي.
- مزامنة العملاء والفواتير مع الأنظمة المحاسبية لتبسيط الإغلاق المالي
- ربط مراحل الصفقات بنظام ERP لإطلاق العمليات التشغيلية تلقائياً
- تكامل مع المتاجر الإلكترونية لتحديث حالات الطلبات وإشعار العملاء عبر واتساب
- بناء تدفّقات في الاتجاهين: من ProBase إلى أنظمتك، ومنها إلى ProBase
توثيق شامل وSDKs وأمثلة جاهزة
وثائق الـ API هي نقطة انطلاق المطوّر: مرجع كامل لكل نقطة نهاية (endpoint) مع المعاملات وأمثلة الطلب والاستجابة، إلى جانب أدلّة للبدء السريع وأنماط التكامل الشائعة. نوفّر مكتبات تطوير (SDKs) ومقتطفات شيفرة جاهزة لتقليص الوقت بين قراءة الوثيقة وتشغيل أول نداء ناجح، حتى يركّز فريقك على منطق عمله بدل تفاصيل البنية التحتية.
- مرجع API تفاعلي يغطّي كل نقطة نهاية بأمثلة طلب واستجابة فعلية
- أدلّة بدء سريع تأخذك من إنشاء المفتاح إلى أول نداء ناجح في دقائق
- أمثلة عملية لأكثر سيناريوهات التكامل شيوعاً
- مكتبات SDK لتسريع التطوير وتقليل الشيفرة المتكرّرة
برنامج المطوّرين والدعم الفني
نتعامل مع المطوّرين كشركاء، لا كمستخدمين تقنيين فقط. يمنحك برنامج المطوّرين وصولاً منظّماً إلى الوثائق، ومفاتيح بيئة الاختبار، وقناة دعم تقني تفهم بنية المنصّة. إن كان لديك تكامل معقّد يربط عدّة أنظمة، يمكن لفريقنا مساعدتك في تصميم البنية الصحيحة منذ البداية لتفادي إعادة البناء لاحقاً.
- وصول مباشر إلى وثائق API ومفاتيح بيئة الاختبار
- دعم تقني يفهم تفاصيل الواجهات وأحداث Webhooks
- مشورة في تصميم التكاملات متعدّدة الأنظمة قبل التنفيذ
- إشعار مسبق بالتغييرات المؤثّرة في الإصدارات للحفاظ على استقرار تكاملاتك
أسئلة شائعة
هل أحتاج خبرة برمجية متقدّمة لاستخدام الـ API؟
تحتاج إلى مطوّر يجيد التعامل مع واجهات REST وطلبات HTTP. صُمّمت الواجهات لتتبع معايير معروفة، والوثائق والأمثلة ومكتبات الـ SDK تقلّل منحنى التعلّم بشكل كبير. للتكاملات المعقّدة، يمكن لفريق المطوّرين لدينا مساعدتك في التصميم.
كيف أبدأ دون التأثير على بيانات عملائي الفعليين؟
ابدأ في بيئة الاختبار (Sandbox) المعزولة تماماً عن الإنتاج. أنشئ مفتاح اختبار، جرّب نداءات الـ API، وحاكِ أحداث Webhooks ببيانات وهمية. وعندما يصبح التكامل جاهزاً، انقله إلى مفتاح الإنتاج.
ما الفرق بين الـ API وWebhooks؟ ومتى أستخدم كلاً منهما؟
تستخدم الـ API عندما تريد أنت أن تطلب أو تنشئ بيانات (مثل إنشاء صفقة أو سحب قائمة عملاء). أمّا Webhooks فتستخدمها عندما تريد أن تُخطَر فور وقوع حدث في ProBase (مثل وصول رسالة أو إصدار فاتورة) دون الحاجة للسؤال المتكرّر. غالباً ستستخدم الاثنين معاً.
هل يمكن ربط ProBase بنظام ERP أو محاسبة موجود لدينا؟
نعم. تتيح الواجهات البرمجية وWebhooks بناء تزامن في الاتجاهين مع أنظمتك الداخلية مثل تخطيط الموارد (ERP) والمحاسبة والمتاجر الإلكترونية. تفاصيل التكامل تعتمد على واجهات النظام الآخر، ويمكن لفريق المطوّرين مساعدتك في رسم البنية المناسبة.
ماذا يحدث إذا تجاوزت حدود المعدّل؟
حدود المعدّل سخيّة ومناسبة للاستخدام التشغيلي الطبيعي، وكل استجابة تتضمّن ترويسات تبيّن رصيدك المتبقّي. عند تجاوز الحدّ مؤقتاً تتلقّى استجابة واضحة تطلب إعادة المحاولة بعد قليل، ما يساعدك على ضبط معدّل طلباتك برمجياً.
ابدأ من وثائق الـ API، أنشئ مفتاحك الأول في بيئة الاختبار، أو احجز جلسة مع فريق المطوّرين لتصميم تكامل يناسب أنظمتك.
فريقنا يتحدث لغتك ويفهم السوق السعودي.