الأسئلة الشائعة
ما هو تطبيق DZBuild؟
تطبيق DZBuild هو خدمة تشغّلها على خوادمك أنت. يثبّته مالك المتجر من لوحة تحكم DZBuild عبر شاشة موافقة OAuth 2.0، ثم يقرأ خادمك بيانات ذلك المتجر ويعدّلها عبر واجهة REST على https://api.dzbuild.app/v1. لا يعمل أي جزء من كودك على DZBuild. تصف صفحة المفاهيم الأساسية التطبيقات والتثبيتات والمتاجر والرموز.
من يستطيع بناء تطبيق DZBuild؟
أي حساب DZBuild يملك متجراً يستطيع فتح منصة المطورين وتسجيل حتى 10 تطبيقات وتجربتها على متاجره. يستطيع التجار الآخرون تثبيت التطبيق بعد أن تراجعه DZBuild وتقبله. تشرح صفحة البدء التطبيق الأول خطوة بخطوة.
أي خطط المتاجر تستطيع تثبيت تطبيق؟
كل الخطط، من Free إلى Enterprise. شرط خطة Enterprise الذي ينطبق على مفاتيح API الخاصة بالتجار لا ينطبق على رموز تثبيت التطبيقات. يستطيع المطور تحديد خطة دنيا للتطبيق؛ المتاجر الأدنى منها لا تستطيع تثبيته وتحصل على الرد 403 app_plan_required. انظر الخطط وmin_plan في المفاهيم الأساسية.
هل تنتهي صلاحية رموز التثبيت؟
لا. لا تعيد نقطة الرمز أي expires_in ولا رمز تحديث. يعمل الرمز حتى يزيل التاجر التطبيق، فيُلغى، أو يثبّته من جديد على المتجر نفسه، فيُستبدل. انظر مدة صلاحية الرمز في صفحة OAuth.
كيف أجرّب التطبيق قبل قبوله؟
التطبيق الجديد مسودة ويعمل في وضع التجربة: يُثبَّت فقط على المتاجر التي يملكها حسابك، ببيانات حقيقية. سجّل رابط إعادة توجيه بـ https، وانشر التطبيق على عنوان workers.dev (أو شغّل نفقاً https)، وثبّت التطبيق على متجرك من عنوان التفويض، واستدعِ GET /v1/whoami بالرمز. الخطوات في صفحة البدء.
هل يستطيع تطبيقي إرسال رسائل WhatsApp إلى المشترين؟
نعم، بالصلاحية whatsapp:send. يرسل تطبيقك قوالب الطلبات التي اعتمدتها Meta لصالح DZBuild، بالعربية أو الفرنسية، وتكلف كل رسالة رصيداً واحداً من محفظة WhatsApp الخاصة بالمتجر. النص الحر والقوالب الخاصة غير متاحة. انظر واجهة WhatsApp.
ما أحداث 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.
هل يستطيع Worker على workers.dev استقبال إشعارات webhook؟
لا. ترفض DZBuild عناوين webhook على workers.dev. ضع الـ Worker على نطاق تملكه في حسابك على Cloudflare، أو استعلم GET /v1/orders?since= مرة كل دقيقة لجلب الطلبات الجديدة، وهذا ما يفعله قالب «تنبيهات الطلبات».
ما الذي تتحقق منه مراجعة تطبيقات DZBuild؟
بطاقة التطبيق (الاسم، الشعار، الأوصاف بالإنجليزية والعربية والفرنسية، الموقع، بريد الدعم)، وروابط إعادة التوجيه، والصلاحيات المطلوبة مقارنة بما تقوله البطاقة، ورابط webhook والتحقق منه، وحساب المطور، وتثبيتات التجربة، وقواعد الأمان: روابط إعادة توجيه دقيقة، أسرار محفوظة في الخادم، توقيعات متحقق منها، حذف البيانات بعد الإزالة، لا استخراج للصفحات، وبريد دعم يُرد عليه. تسرد إرشادات المراجعة ما تشترطه منصة المطورين قبل الإرسال.
هل يستطيع التطبيق إدارة مفاتيح API أو webhook عبر الواجهة؟
لا. ترد /v1/keys و/v1/webhooks و/v1/changes بـ 403 والرسالة Apps cannot use this endpoint على أي رمز تثبيت. يُضبط رابط webhook الخاص بالتطبيق مرة واحدة في منصة المطورين ويستقبل أحداث كل متجر يثبّت التطبيق. انظر نقاط الوصول المغلقة أمام التطبيقات في مرجع الواجهة البرمجية.
هل أستطيع استخدام هذا التوثيق مع مساعد برمجة بالذكاء الاصطناعي؟
نعم. لكل صفحة نسخة 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. تشرح صفحة التطوير مع وكلاء الذكاء الاصطناعي كيفية استخدامها.