# DZBuild Developers

> Developer documentation for DZBuild, the e-commerce platform for Algerian merchants. Third-party apps use OAuth 2.0 with PKCE to get one install token per store, call the REST API at https://api.dzbuild.app/v1 and receive webhooks signed with X-DZ-Signature.


## ar

- [أنشئ تطبيقات لمتاجر DZBuild](https://dzbuild.dev/ar/index.md): منصة مطوّري DZBuild، منصة التجارة الإلكترونية للتجار في الجزائر. تطبيقات OAuth، رمز تثبيت واحد لكل متجر، واجهة REST للطلبات والمنتجات والتوصيل وWhatsApp، وإشعارات webhook موقّعة.
- [مرجع الواجهة البرمجية](https://dzbuild.dev/ar/api-reference.md): أين تجد مرجع واجهة DZBuild البرمجية بالعربية والفرنسية والإنجليزية، وكيف تنزّل ملف وصف OpenAPI لاستخدامه في أدوات التطوير.
- [التطوير مع وكلاء الذكاء الاصطناعي](https://dzbuild.dev/ar/build-with-ai.md): استخدم Claude Code أو Codex أو Cursor أو ChatGPT أو أي وكيل برمجة لبناء تطبيق DZBuild. أين توجد صفحات Markdown وllms.txt ومهارة الوكيل ووصف OpenAPI، وكيف تبقي الأسرار خارج المحادثة.
- [سجل التغييرات](https://dzbuild.dev/ar/changelog.md): التغييرات المؤرّخة على منصة مطوّري DZBuild: صلاحيات ونقاط وصول وأحداث webhook جديدة، وكل تغيير يمسّ التطبيقات المثبّتة من قبل.
- [المفاهيم الأساسية](https://dzbuild.dev/ar/concepts.md): كيف تعمل تطبيقات DZBuild: التطبيقات والتثبيتات والمتاجر والخطط، وإعداد min_plan، وحدّ معدّل الطلبات الذي يخص كل تثبيت على حدة.
- [الأخطاء](https://dzbuild.dev/ar/errors.md): كل خطأ يمكن أن يواجهه تطبيق DZBuild في صفحة واحدة. غلاف الخطأ في الواجهة، الأكواد من 400 إلى 502 مع رسائلها، أخطاء OAuth في التفويض والتبادل، أكواد WhatsApp، وإخفاقات إرسال إشعارات webhook.
- [الأسئلة الشائعة](https://dzbuild.dev/ar/faq.md): إجابات قصيرة عن بناء التطبيقات لمتاجر DZBuild. ما التطبيق، ومن يستطيع بناءه، والخطط، وانتهاء الرموز، والتجربة المحلية، ورسائل WhatsApp، وأحداث webhook، والمراجعة، والتطوير بمساعدة الذكاء الاصطناعي.
- [البدء](https://dzbuild.dev/ar/getting-started.md): أنشئ أول تطبيق لك على DZBuild: سجّله في منصة المطورين، اختر الصلاحيات، ثبّته على متجرك ثم نفّذ أول طلب إلى الواجهة البرمجية.
- [أقسام الصفحة الرئيسية](https://dzbuild.dev/ar/home-layout.md): اقرأ أقسام الصفحة الرئيسية للمتجر وغيّرها من تطبيقك، مع أنواع الأقسام العشرة ونقاط الوصول الست وحدود الخطة والتراجع ورموز الأخطاء.
- [توثيق المطورين في DZBuild](https://dzbuild.dev/ar/intro.md): أنشئ تطبيقات لمتاجر DZBuild: سجّل تطبيق OAuth، ثبّته على متجر أحد التجار، استدعِ واجهة REST واستقبل إشعارات webhook موقّعة.
- [مسار التثبيت عبر OAuth](https://dzbuild.dev/ar/oauth.md): مسار OAuth لتطبيقات DZBuild: معاملات طلب التفويض، موافقة التاجر، PKCE بطريقة S256، تبادل الرمز، وجميع رموز الأخطاء التي يعيدها.
- [حدود معدّل الطلبات](https://dzbuild.dev/ar/rate-limits.md): حدود معدّل الطلبات لرموز تطبيقات DZBuild: الحصة الخاصة بكل تثبيت، حصة المتجر، ترويسة Idempotency-Key، والردّان 402 و429.
- [إرشادات المراجعة](https://dzbuild.dev/ar/review-guidelines.md): ما تتحقق منه DZBuild قبل اعتماد التطبيق لجميع التجار، وكيف تجهّز تطبيقك وبطاقة عرضه وبيانات التواصل مع الدعم قبل إرساله للمراجعة.
- [الصلاحيات](https://dzbuild.dev/ar/scopes.md): الصلاحيات التي يمكن لتطبيق DZBuild طلبها، وما تتيحه كل صلاحية في واجهة REST، وكيف يراها التاجر في شاشة الموافقة قبل التثبيت.
- [متطلبات الأمان](https://dzbuild.dev/ar/security.md): قواعد الأمان التي يلتزم بها كل تطبيق DZBuild: عناوين إعادة توجيه مطابقة تماما، سرّ العميل على الخادم فقط، التحقق من الإشعارات وحذف البيانات.
- [إشعارات Webhook](https://dzbuild.dev/ar/webhooks.md): استقبل إشعارات webhook موقّعة من DZBuild في تطبيقك: قائمة الأحداث، ترويسة X-DZ-Signature، مهلة صلاحية التوقيع وأمثلة التحقق.
- [واجهة WhatsApp](https://dzbuild.dev/ar/whatsapp.md): أرسل من تطبيقك قوالب WhatsApp الخاصة بالطلبات والمعتمدة من المنصة، مدفوعة من رصيد المتجر، واطّلع على القوالب والرصيد والرسائل.