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

سجل التغييرات

تسرد هذه الصفحة التغييرات المؤرّخة على منصة مطوّري DZBuild. التغييرات على واجهة REST الخاصة بالتجار التي لا تخص التطبيقات موجودة في سجل تغييرات الواجهة البرمجية على dzbuild.com.

2026-10-08: حقول تصميم المتجر وقوائم القوالب​

تصل التطبيقات التي تحمل store:read وstore:write إلى المزيد من تصميم المتجر:

  • حقول شريط الشراء في GET /v1/store/design وPATCH /v1/store/design: مفاتيح التشغيل والإيقاف buybar_show_mobile وbuybar_show_qty وfc_show_qty، وproduct_button_size (normal أو large)، مفتوحة في كل الخطط.
  • GET /v1/store يُرجع store_theme وfast_checkout_theme وvariant_card_style، للقراءة فقط.
  • GET /v1/themes يضيف القائمتين fast_checkout وvariant_styles، ولكل عنصر خطته وcan_use وcurrent.
  • change_id في استجابات PATCH /v1/store/design ونداءات تبديل القوالب الثلاثة. وما زالت رموز التثبيت تتلقى 403 على /v1/changes.

2026-09-26: إطلاق المنصة​

أصبحت تطبيقات الأطراف الخارجية متاحة للمطورين. يتضمن هذا الإصدار:

  • منصة المطورين في https://dzbuild.com/dashboard/developer. سجّل تطبيقاً، واحصل على client_id وسرّ العميل ومفتاح التوقيع، وجدّد السرّين، وجرّب على متاجرك، وأرسل التطبيق للمراجعة.
  • مسار التثبيت: OAuth 2.0 بنوع authorization code مع PKCE بطريقة S256 فقط. يعرض GET /oauth/apps/authorize شاشة الموافقة، ويعيد POST /oauth/apps/token رموز التثبيت. موافقة واحدة تشمل 10 متاجر كحد أقصى يملكها التاجر. راجع OAuth.
  • رموز التثبيت: رمز Bearer واحد يبدأ بـ dzpk_live_ لكل متجر، محدود بالصلاحيات الموافق عليها، دون تاريخ انتهاء. إزالة التطبيق تلغيه. يمكن لأي خطة متجر تثبيت تطبيق، واضبط min_plan لتشترط خطة أعلى.
  • 19 صلاحية للتطبيقات، تغطي المتجر والمنتجات والطلبات والتوصيل والعملاء وصفحات الهبوط وأكواد التخفيض والبكسلات والشحن والإحصائيات وWhatsApp. الصلاحية ai:generate غير متاحة للتطبيقات. راجع الصلاحيات.
  • كائن التطبيق في GET /v1/whoami: app_id وclient_id وinstall_id للطلبات المنفّذة برمز تثبيت.
  • حدّ معدّل لكل تثبيت قدره 120 طلباً في الدقيقة، يُفحص قبل الحدّ المشترك للمتجر. راجع حدود معدّل الطلبات.
  • أخطاء التطبيقات: 403 مع app_uninstalled أو app_suspended أو app_not_approved أو app_plan_required. رموز التثبيت تحصل على 403 في /v1/keys و/v1/webhooks و/v1/changes.
  • إشعارات webhook للتطبيقات: أحداث الطلبات وapp.uninstalled، موقّعة بـ X-DZ-Signature. أحداث الطلبات تتطلب الصلاحية orders:read. راجع إشعارات webhook.
  • رابط الفتح: يعيد زر الفتح لدى التاجر التوجيه إلى رابط الفتح الخاص بك مع رمز موقّع بـ HS256 في dz_launch، صالح 5 دقائق.
  • واجهة WhatsApp: GET /v1/whatsapp/templates وGET /v1/whatsapp/balance وGET /v1/whatsapp/messages وPOST /v1/orders/{id}/whatsapp، بالصلاحيتين whatsapp:read وwhatsapp:send. راجع واجهة WhatsApp.
  • وصف OpenAPI للواجهة /v1 العلنية، قابل للتنزيل من مرجع الواجهة البرمجية.
هذه الصفحة لأدوات الذكاء الاصطناعيعرض بصيغة Markdownفتح في ChatGPTفتح في Claude