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

`DZBuild` ([dzbuild.com](https://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](https://dzbuild.com/ar/docs/intro). وهو يشرح لوحة التحكم من جهة التاجر.

## الخطوة التالية[​](#الخطوة-التالية "رابط مباشر إلى الخطوة التالية")

* [البدء](https://dzbuild.dev/ar/ar/getting-started.md): سجّل تطبيقاً وثبّته على متجرك ونفّذ أول طلب إلى الواجهة البرمجية.
* [المفاهيم الأساسية](https://dzbuild.dev/ar/ar/concepts.md): التطبيقات والتثبيتات والمتاجر والخطط ووضع التجربة والحدّ الخاص بكل تثبيت ورموز التثبيت.
* [OAuth](https://dzbuild.dev/ar/ar/oauth.md): كل معاملات التفويض وتبادل الرمز، وكل رموز الأخطاء.
* [الصلاحيات](https://dzbuild.dev/ar/ar/scopes.md): ما تسمح به كل صلاحية.
* [إشعارات webhook](https://dzbuild.dev/ar/ar/webhooks.md): الأحداث والتحقق من التوقيع.
* [واجهة WhatsApp](https://dzbuild.dev/ar/ar/whatsapp.md): إرسال قوالب الطلبات.
* [حدود معدّل الطلبات](https://dzbuild.dev/ar/ar/rate-limits.md): حصص الطلبات وإعادة المحاولة.
* [مرجع الواجهة البرمجية](https://dzbuild.dev/ar/ar/api-reference.md): كل نقاط `/v1` ووصف `OpenAPI`.
* [إرشادات المراجعة](https://dzbuild.dev/ar/ar/review-guidelines.md) و[الأمان](https://dzbuild.dev/ar/ar/security.md): ما تتحقق منه `DZBuild` قبل قبول التطبيق.
* [سجل التغييرات](https://dzbuild.dev/ar/ar/changelog.md): التغييرات المؤرّخة على المنصة.