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

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

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 العلنية، قابل للتنزيل من مرجع الواجهة البرمجية.