# الأسئلة الشائعة

## ما هو تطبيق DZBuild؟[​](#ما-هو-تطبيق-dzbuild "رابط مباشر إلى ما هو تطبيق DZBuild؟")

تطبيق `DZBuild` هو خدمة تشغّلها على خوادمك أنت. يثبّته مالك المتجر من لوحة تحكم `DZBuild` عبر شاشة موافقة `OAuth 2.0`، ثم يقرأ خادمك بيانات ذلك المتجر ويعدّلها عبر واجهة `REST` على `https://api.dzbuild.app/v1`. لا يعمل أي جزء من كودك على `DZBuild`. تصف صفحة [المفاهيم الأساسية](https://dzbuild.dev/ar/ar/concepts.md) التطبيقات والتثبيتات والمتاجر والرموز.

## من يستطيع بناء تطبيق DZBuild؟[​](#من-يستطيع-بناء-تطبيق-dzbuild "رابط مباشر إلى من يستطيع بناء تطبيق DZBuild؟")

أي حساب `DZBuild` يملك متجراً يستطيع فتح [منصة المطورين](https://dzbuild.com/dashboard/developer) وتسجيل حتى 10 تطبيقات وتجربتها على متاجره. يستطيع التجار الآخرون تثبيت التطبيق بعد أن تراجعه `DZBuild` وتقبله. تشرح صفحة [البدء](https://dzbuild.dev/ar/ar/getting-started.md) التطبيق الأول خطوة بخطوة.

## أي خطط المتاجر تستطيع تثبيت تطبيق؟[​](#أي-خطط-المتاجر-تستطيع-تثبيت-تطبيق "رابط مباشر إلى أي خطط المتاجر تستطيع تثبيت تطبيق؟")

كل الخطط، من `Free` إلى `Enterprise`. شرط خطة `Enterprise` الذي ينطبق على مفاتيح `API` الخاصة بالتجار لا ينطبق على رموز تثبيت التطبيقات. يستطيع المطور تحديد خطة دنيا للتطبيق؛ المتاجر الأدنى منها لا تستطيع تثبيته وتحصل على الرد `403` `app_plan_required`. انظر الخطط و`min_plan` في [المفاهيم الأساسية](https://dzbuild.dev/ar/ar/concepts.md).

## هل تنتهي صلاحية رموز التثبيت؟[​](#هل-تنتهي-صلاحية-رموز-التثبيت "رابط مباشر إلى هل تنتهي صلاحية رموز التثبيت؟")

لا. لا تعيد نقطة الرمز أي `expires_in` ولا رمز تحديث. يعمل الرمز حتى يزيل التاجر التطبيق، فيُلغى، أو يثبّته من جديد على المتجر نفسه، فيُستبدل. انظر مدة صلاحية الرمز في صفحة [OAuth](https://dzbuild.dev/ar/ar/oauth.md).

## كيف أجرّب التطبيق قبل قبوله؟[​](#كيف-أجرّب-التطبيق-قبل-قبوله "رابط مباشر إلى كيف أجرّب التطبيق قبل قبوله؟")

التطبيق الجديد مسودة ويعمل في وضع التجربة: يُثبَّت فقط على المتاجر التي يملكها حسابك، ببيانات حقيقية. سجّل رابط إعادة توجيه بـ `https`، وانشر التطبيق على عنوان `workers.dev` (أو شغّل نفقاً `https`)، وثبّت التطبيق على متجرك من عنوان التفويض، واستدعِ `GET /v1/whoami` بالرمز. الخطوات في صفحة [البدء](https://dzbuild.dev/ar/ar/getting-started.md).

## هل يستطيع تطبيقي إرسال رسائل WhatsApp إلى المشترين؟[​](#هل-يستطيع-تطبيقي-إرسال-رسائل-whatsapp-إلى-المشترين "رابط مباشر إلى هل يستطيع تطبيقي إرسال رسائل WhatsApp إلى المشترين؟")

نعم، بالصلاحية `whatsapp:send`. يرسل تطبيقك قوالب الطلبات التي اعتمدتها `Meta` لصالح `DZBuild`، بالعربية أو الفرنسية، وتكلف كل رسالة رصيداً واحداً من محفظة `WhatsApp` الخاصة بالمتجر. النص الحر والقوالب الخاصة غير متاحة. انظر [واجهة WhatsApp](https://dzbuild.dev/ar/ar/whatsapp.md).

## ما أحداث webhook التي ترسلها DZBuild إلى التطبيقات؟[​](#ما-أحداث-webhook-التي-ترسلها-dzbuild-إلى-التطبيقات "رابط مباشر إلى ما أحداث webhook التي ترسلها DZBuild إلى التطبيقات؟")

`order.created` و`order.confirmed` و`order.processing` و`order.shipped` و`order.delivered` و`order.cancelled` و`order.returned`، إضافة إلى `app.uninstalled` وطلب `webhook.verify` المرسل من منصة المطورين. تحتاج أحداث الطلبات إلى الصلاحية `orders:read` لأن الحمولة تحمل اسم المشتري وهاتفه وعنوانه. كل طلب موقّع بـ `X-DZ-Signature`. انظر [إشعارات Webhook](https://dzbuild.dev/ar/ar/webhooks.md).

## هل يستطيع Worker على workers.dev استقبال إشعارات webhook؟[​](#هل-يستطيع-worker-على-workersdev-استقبال-إشعارات-webhook "رابط مباشر إلى هل يستطيع Worker على workers.dev استقبال إشعارات webhook؟")

لا. ترفض `DZBuild` عناوين `webhook` على `workers.dev`. ضع الـ `Worker` على نطاق تملكه في حسابك على `Cloudflare`، أو استعلم `GET /v1/orders?since=` مرة كل دقيقة لجلب الطلبات الجديدة، وهذا ما يفعله قالب «تنبيهات الطلبات».

## ما الذي تتحقق منه مراجعة تطبيقات DZBuild؟[​](#ما-الذي-تتحقق-منه-مراجعة-تطبيقات-dzbuild "رابط مباشر إلى ما الذي تتحقق منه مراجعة تطبيقات DZBuild؟")

بطاقة التطبيق (الاسم، الشعار، الأوصاف بالإنجليزية والعربية والفرنسية، الموقع، بريد الدعم)، وروابط إعادة التوجيه، والصلاحيات المطلوبة مقارنة بما تقوله البطاقة، ورابط `webhook` والتحقق منه، وحساب المطور، وتثبيتات التجربة، و[قواعد الأمان](https://dzbuild.dev/ar/ar/security.md): روابط إعادة توجيه دقيقة، أسرار محفوظة في الخادم، توقيعات متحقق منها، حذف البيانات بعد الإزالة، لا استخراج للصفحات، وبريد دعم يُرد عليه. تسرد [إرشادات المراجعة](https://dzbuild.dev/ar/ar/review-guidelines.md) ما تشترطه منصة المطورين قبل الإرسال.

## هل يستطيع التطبيق إدارة مفاتيح API أو webhook عبر الواجهة؟[​](#هل-يستطيع-التطبيق-إدارة-مفاتيح-api-أو-webhook-عبر-الواجهة "رابط مباشر إلى هل يستطيع التطبيق إدارة مفاتيح API أو webhook عبر الواجهة؟")

لا. ترد `/v1/keys` و`/v1/webhooks` و`/v1/changes` بـ `403` والرسالة `Apps cannot use this endpoint` على أي رمز تثبيت. يُضبط رابط `webhook` الخاص بالتطبيق مرة واحدة في منصة المطورين ويستقبل أحداث كل متجر يثبّت التطبيق. انظر نقاط الوصول المغلقة أمام التطبيقات في [مرجع الواجهة البرمجية](https://dzbuild.dev/ar/ar/api-reference.md).

## هل أستطيع استخدام هذا التوثيق مع مساعد برمجة بالذكاء الاصطناعي؟[​](#هل-أستطيع-استخدام-هذا-التوثيق-مع-مساعد-برمجة-بالذكاء-الاصطناعي "رابط مباشر إلى هل أستطيع استخدام هذا التوثيق مع مساعد برمجة بالذكاء الاصطناعي؟")

نعم. لكل صفحة نسخة `Markdown` على العنوان نفسه مع `.md`، والفهرس هو `https://dzbuild.dev/llms.txt`، والموقع كله في `https://dzbuild.dev/llms-full.txt`، ومهارة الوكيل في `https://dzbuild.dev/skills/dzbuild-apps/SKILL.md` تحمل القواعد التي يحتاجها المساعد. وصف `OpenAPI` للتطبيقات في `https://dzbuild.dev/openapi/dzbuild-apps-v1.json`. تشرح صفحة [التطوير مع وكلاء الذكاء الاصطناعي](https://dzbuild.dev/ar/ar/build-with-ai.md) كيفية استخدامها.