إنتقل إلى المحتوى الرئيسي

توثيق المطورين في DZBuild

DZBuild (dzbuild.com) هي منصة التجارة الإلكترونية للتجار في الجزائر: متاجر إلكترونية بالدفع عند الاستلام، وتوصيل عبر شركات التوصيل إلى الولايات، وصفحات هبوط، ورسائل WhatsApp للطلبات. تطبيق DZBuild خدمة تشغّلها على خوادمك أنت. يثبّته صاحب المتجر، فيقرأ خادمك بيانات ذلك المتجر ويعدّلها عبر واجهة REST. لا يُشغَّل أي جزء من شيفرتك على DZBuild.

ما تقدّمه المنصة​

العنصرما يمنحه لتطبيقك
التطبيقاتتسجّل تطبيقك في منصة المطورين، فيحصل على client_id وسرّ العميل ومفتاح التوقيع.
مسار التثبيتيوافق صاحب المتجر على تطبيقك في شاشة الموافقة. المسار هو OAuth 2.0 بنوع authorization code مع PKCE بطريقة S256.
رموز التثبيتكل متجر يثبّت تطبيقك يحصل على رمز Bearer خاص به، محدود بالصلاحيات التي وافق عليها صاحب المتجر.
واجهة RESTيغطي https://api.dzbuild.app/v1 المتجر والمنتجات والطلبات والتوصيل والعملاء وصفحات الهبوط وأكواد التخفيض والبكسلات والشحن والإحصائيات وWhatsApp.
إشعارات webhookترسل DZBuild أحداث الطلبات والحدث app.uninstalled إلى رابطك، موقّعة بالترويسة X-DZ-Signature.
واجهة WhatsAppيرسل تطبيقك قوالب الطلبات المعتمدة على المنصة إلى المشترين. تُدفع كل رسالة من رصيد WhatsApp الخاص بالمتجر.
رابط الفتحيوجّه زر الفتح في لوحة تحكم التاجر إلى تطبيقك مع رمز موقّع في dz_launch.
منصة المطورينفي https://dzbuild.com/dashboard/developer تسجّل تطبيقاتك وتجدّد أسرارها وتجرّبها على متجرك وترسلها للمراجعة.

لمن هذا التوثيق​

هذه الصفحات موجّهة للمطورين الذين يبنون أدوات يثبّتها تجار DZBuild من لوحة تحكمهم. يستطيع أي حساب على DZBuild لديه متجر فتح منصة المطورين. ما دام التطبيق مسودة أو قيد المراجعة، فلا يُثبَّت إلا على المتاجر التي يملكها حساب المطور. بعد أن توافق عليه DZBuild، يستطيع أي صاحب متجر تثبيته مهما كانت خطته، إلا إذا حدّدتَ خطة دنيا.

توثيق التجار موجود في dzbuild.com/docs. وهو يشرح لوحة التحكم من جهة التاجر.

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

هذه الصفحة لأدوات الذكاء الاصطناعيعرض بصيغة Markdownفتح في ChatGPTفتح في Claude