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

أنشئ تطبيقات لمتاجر DZBuild

ابنِ أداة يثبّتها أي تاجر على متجره في DZBuild، أو أداة خاصة تؤتمت متجرك أنت. ابدأ بمثال جاهز، أو بأمر جاهز لمساعدك الذكي، أو بالواجهة البرمجية مباشرة.

أنت تستضيف التطبيق، والتاجر يختار بيانات المتجر التي يسمح له بالوصول إليها.

أعطِ وكيل البرمجة سطرًا واحدًا

Read https://dzbuild.dev/llms.txt and https://dzbuild.dev/skills/dzbuild-apps/SKILL.md. Then help me build a DZBuild app.

من طلب الواجهة البرمجية إلى تصدير الكتالوج.

cloudflare-catalogمثال تطبيق

كتالوج متجر جاهز للتصدير

يعرض مثال الكتالوج منتجات المتجر ويتيح للتاجر تحميلها في ملف CSV.

  1. يربط التاجر متجرهOAuth
  2. يقرأ تطبيقك المنتجاتproducts:read
  3. يحمّل التاجر الكتالوجCSV

طريقتان للبناء على DZBuild

للمطوّرين

ابنِ تطبيقًا يثبّته أي تاجر

  • تثبيت عبر OAuth، ورمز لكل متجر، وwebhooks موقّعة
  • الطلبات والمنتجات والتوصيل والزبائن وواتساب في واجهة REST واحدة
  • يظهر في لوحة التحكم بعد مراجعة DZBuild له

للتجّار

أتمِت متجرك بالذكاء الاصطناعي

  • على أي خطة: مساعد ذكي يبني لك تطبيقًا خاصًا لا تثبّته إلا متاجرك
  • مبيعات اليوم على تيليغرام، والطلبات في Google Sheets، وتنبيهات نفاد المخزون، وتغيير الأسعار دفعة واحدة
  • خطة Enterprise: أدِر المتجر بالمحادثة مع Claude أو ChatGPT

كيف يعمل التطبيق

  1. سجّل التطبيق

    أنشئه في منصة المطورين. تحصل على client_id وسرّ عميل يُعرض مرة واحدة وسرّ توقيع لإشعارات webhook وروابط الفتح.

    ابدأ الآن
  2. يثبّته التاجر

    وجّه التاجر إلى عنوان التفويض مع تحدّي PKCE. يوافق على شاشة موافقة DZBuild، ويستبدل خادمك الرمز برمز تثبيت واحد لكل متجر.

    مسار OAuth
  3. استدعِ الواجهة البرمجية

    أرسل الرمز إلى api.dzbuild.app/v1. استعلم بـ GET /v1/orders?since= عن الطلبات الجديدة، أو استقبل أحداث الطلبات الموقّعة على رابط webhook في نطاق تملكه (DZBuild ترفض عناوين workers.dev). جرّب على متجرك، ثم أرسل التطبيق للمراجعة.

    إشعارات Webhook
شاهد مثال موافقة التاجر والاستجابة التي تحمل رمز الوصول

DZBuild هي منصة التجارة الإلكترونية للتجار في الجزائر. تطبيق DZBuild هو خدمة ويب تستضيفها أنت، على حساب Cloudflare الخاص بك أو على خادمك. يثبّته التاجر على متجره، فيقرأ تطبيقك طلبات ذلك المتجر ومنتجاته وتوصيله وعملاءه ورسائل WhatsApp ويعدّلها عبر واجهة REST.

يوافق التاجر على DZBuild

تثبيت orders-bot على متجرك

يطلب orders-bot الوصول إلى متجرك. بعد موافقتك يستطيع القيام بما يلي فقط.

ما يستطيع هذا التطبيق فعله

عرض الطلبات (قراءة فقط؛ لا يمكنه إنشاء أو تعديل الطلبات) orders:read

رفضموافقة وتثبيت

يمكنك إزالة التطبيق في أي وقت من صفحة الإضافات.

يستبدل خادمك رمز التفويض برمز التثبيت

POST https://dzbuild.com/oauth/apps/token

200 OK
{
  "access_token": "dzpk_live_0a1b2c3d4e5f67.9f8e...",
  "token_type": "Bearer",
  "scope": "orders:read",
  "store_id": 141,
  "install_id": 7,
  "stores": [
    {
      "store_id": 141,
      "store_name": "My test store",
      "install_id": 7,
      "access_token": "dzpk_live_0a1b2c3d4e5f67.9f8e..."
    }
  ]
}
مسار OAuth

مكتبة الأوامر

الصق أمرًا، واحصل على أداة تعمل

كل أمر تطبيق يوجّه المساعد إلى هذه الوثائق أولًا، فيبني Claude أو ChatGPT أو Codex أو Cursor على الواجهة البرمجية الحقيقية. كل الأوامر (18)

أرسل كل طلب جديد إلى مجموعة تيليغرام

رسالة تيليغرام واحدة لكل طلب، دون تكرار، من تطبيق يقرأ قائمة الطلبات كل دقيقة.

orders:read

Read https://dzbuild.dev/llms.txt and https://dzbuild.dev/skills/dzbuild-apps/SKILL.md. Build a DZBuild app that posts every new order to a Telegram group. Start from the cloudflare-orders preset of https://github.com/DZBuild-com/dzbuild-app-starter. New orders come from polling GET /v1/orders?since= once a minute, because the app runs on workers.dev and cannot receive webhooks yet. One Telegram message per order, never twice; the bot token is a Worker secret.

تقرير مبيعاتي على تيليغرام كل مساء

على الساعة 21:00 بتوقيت الجزائر: الطلبات المستلمة والمؤكدة والمشحونة والمسلّمة والملغاة والمرتجعة اليوم.

orders:readanalytics:read

Read https://dzbuild.dev/llms.txt and https://dzbuild.dev/skills/dzbuild-apps/SKILL.md. I sell on DZBuild and I am not a developer. Build me a private DZBuild app for my own store: it stays a draft in the developer console and installs only on stores I own. Every evening at 21:00 Algiers time (20:00 UTC, a Cron Trigger), send me one Telegram message with today's orders counted by status (pending, confirmed, processing, shipped, delivered, cancelled, returned) and the figures from GET /v1/analytics?range=today. Read the orders with GET /v1/orders?since=<today 00:00 Algiers time> and follow data.next_cursor while data.has_more is true. The Telegram bot token is a Worker secret. Start from the cloudflare-orders preset of https://github.com/DZBuild-com/dzbuild-app-starter and host it on my Cloudflare account. Ask only for the scopes orders:read and analytics:read. Tell me exactly what to paste into the developer console and which secrets go into `wrangler secret put`, one step at a time. Explain every step to me in simple Arabic.

اعرض طلبات اليوم المعلّقة حسب الولاية

طلباتك المعلّقة مجمّعة حسب الولاية، مع أرقام الهواتف التي طلبت أكثر من مرة.

اعرض لي طلبات اليوم التي ما زالت معلّقة في متجري على DZBuild، مجمّعة حسب الولاية، مع اسم الزبون ورقم هاتفه والمبلغ. ثم أخبرني بأرقام الهواتف التي طلبت أكثر من مرة.

ما يصل إليه تطبيقك

صلاحية واحدة لكل نوع من بيانات المتجر. يرى التاجر سطراً واحداً لكل مورد على شاشة الموافقة ويمنح ما تطلبه فقط. كل الصلاحيات

  • الطلبات

    قراءة الطلبات وعناصرها. إنشاء الطلبات وتغيير حالتها وإلغاؤها.

    orders:readorders:write
  • التوصيل

    تسليم الطلب إلى شركة التوصيل الخاصة بالمتجر.

    delivery:send
  • المنتجات

    الكتالوج والفئات، مع الصور والمتغيرات والعروض وقواعد الكمية والمخزون.

    products:readproducts:write
  • العملاء

    العملاء وطلبات كل عميل.

    customers:read
  • صفحات الهبوط

    صفحات الهبوط وأقسامها، والفحص الذي يجري قبل النشر.

    landing_pages:readlanding_pages:write
  • الشحن

    الأسعار والإعدادات، وشركات التوصيل المرتبطة، والتغطية، وقوائم الولايات والبلديات.

    shipping:readshipping:write
  • المتجر

    الملف التعريفي والتصميم وأقسام الصفحة الرئيسية والقوالب.

    store:readstore:write
  • أكواد الخصم والبكسلات

    أكواد الخصم وبكسلات التتبع.

    promos:readpromos:writepixels:readpixels:write
  • التحليلات

    تحليلات المتجر ومؤشراته.

    analytics:read
  • WhatsApp

    القوالب المعتمدة للطلبات، ورصيد محفظة المتجر، وسجل الرسائل، والإرسال.

    whatsapp:readwhatsapp:send

قواعد تبني عليها

رمز واحد لكل متجر
تبدأ رموز التثبيت بـ dzpk_live_، وليس لها تاريخ انتهاء، وتُلغى لحظة إزالة التاجر لتطبيقك.
120 طلباً في الدقيقة
لكل تثبيت، ويُفحص قبل ميزانية المتجر المشتركة. يحمل الرد 429 ترويسة Retry-After.
Idempotency-Key على الكتابات
تحتاجه الطلبات من نوع POST أو PATCH أو DELETE. يُحفظ الرد 24 ساعة ويُعاد عند إعادة المحاولة.
إشعارات webhook بتوقيع HMAC-SHA256
يغطي X-DZ-Signature الطابع الزمني والمتن الخام. ارفض ما هو أقدم من 5 دقائق. حتى 5 محاولات إرسال.
إشعارات webhook تحتاج إلى نطاقك الخاص
ترفض DZBuild روابط webhook على workers.dev. إلى أن يعمل التطبيق على نطاق تملكه، استعلم بـ GET /v1/orders?since= مرة كل دقيقة.
أي خطة متجر
يمكن لكل خطة تثبيت التطبيق. حدّد خطة دنيا في منصة المطورين إذا احتاج تطبيقك ذلك.
مراجعة قبل الإدراج
التطبيق في وضع المسودة يعمل فقط على المتاجر التي تملكها. تراجعه DZBuild قبل أن يثبّته التجار الآخرون.

مجاني ومفتوح المصدر

أدوات تستعملها بمتجر أو بدونه

واجهة للتوصيل، وبرنامج صندوق للمحلات، ومكتبة للمتصفح، مجانًا. شاهد كل الأدوات

DZShip

واجهة توصيل مجانية لـ 99 شركة توصيل في الجزائر. دون تسجيل ودون مفتاح API: بيانات دخولك لدى شركة التوصيل، تُستعمل لكل طلب ولا تُحفظ.

اقرأ المزيد

DZBuild POS

برنامج صندوق مجاني لمحلات ويندوز: قارئ الباركود والوصولات والكريدي والنسخ الاحتياطي. يعمل دون إنترنت ويتزامن مع متجر DZBuild.

اقرأ المزيد
VisitoJS

مشروع شريك

مكتبة مفتوحة المصدر للتعرّف على الأجهزة في المتصفح. رخصة MIT، نحو 7.5 كيلوبايت مضغوطة، دون أي طلب عبر الشبكة.

اقرأ المزيد

سجّل تطبيقك الأول

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

تميمة Bunny تقفز

شريك DZBuild

Bunny CDN للملفات المحيطة بتطبيقك

صور وفيديو وتخزين وخدمة DNS من Bunny، مع تجربة مجانية لمدة 14 يومًا دون بطاقة بنكية.

DZBuild شريك لـ Bunny.