✨ إدارة ذاتية للمفاتيح — أصبح بإمكان مالكي المتاجر على خطة Enterprise إنشاء مفاتيح API وإلغاؤها من لوحة التحكم عبر الإعدادات ← واجهة API (/dashboard/api). تُعرض الأسرار مرة واحدة عند الإنشاء.

⚠️ حد المعدل في الدقيقة يُطبَّق الآن لكل متجر، مشتركًا بين جميع مفاتيح المتجر (كان سابقًا لكل مفتاح). سقف Enterprise دون تغيير عند 600 طلب/دقيقة.

⚠️ يمكن للمتجر الآن الاحتفاظ بـ 3 مفاتيح نشطة كحد أقصى (بدلًا من 20)، عبر جميع طرق الإنشاء — لوحة التحكم وPOST /v1/keys والمفاتيح الصادرة من الدعم. إلغاء مفتاح يحرّر مكانه.

⚠️ صارت الواجهة البرمجية حصرية لخطة Enterprise. لا تُوثَّق المفاتيح إلا ما دام متجرها على خطة Enterprise سارية؛ وكل خطة أخرى — وكذلك اشتراك Enterprise منتهي الصلاحية — تتلقى 403 forbidden (برسالة API access requires an active Enterprise plan). ولا تُصدَر المفاتيح الجديدة إلا لمتاجر Enterprise. أما المفاتيح الموجودة لدى متاجر غير Enterprise فتتوقف عن العمل فورًا دون أن تُحذف: تعود إلى العمل لحظة انتقال المتجر إلى Enterprise (أو تجديده)، دون أي إعادة إصدار.

⚠️ أُلغيت خطط حدود المعدل القديمة Free / Pro / Unlimited. ويبقى سقف Enterprise عند 600 طلب/دقيقة لكل مفتاح دون سقف شهري؛ والتجاوزات الخاصة بالمتجر من الدعم تبقى سارية.

✨ صور المنتجات عبر الواجهة البرمجية — POST /v1/products/{id}/images يضيف صورة من رابط https عمومي (تتكفّل DZBuild بتنزيلها وتحسينها واستضافتها)، وPATCH .../images/{image_id} يضبط النص البديل وترتيب العرض والصورة الرئيسية، وDELETE .../images/{image_id} يحذف صورة. الروابط المكرّرة لا تُضاف مرتين، وأول صورة تصبح الرئيسية تلقائيًا، والحد الأقصى 20 صورة لكل منتج.

✨ PUT /v1/products/{id}/variants — إنشاء وإدارة مجموعات الأنواع وخياراتها ومخزون التركيبات في نداء واحد (استبدال كامل). أصبحت الحقول price_adjustment وstock وsku وimage_id وshow_as_card لكل خيار قابلة للكتابة، وتُضبط أعلام وضع المخزون نيابةً عنك.

✨ GET /v1/products/{id} يُرجع الآن كتلة combinations إضافةً إلى حقول الخيارات الكاملة (price_adjustment، sku، show_as_card، sort_order، is_active) والنص البديل alt_text للصور.

⚠️ تغيير مؤثّر: أصبح primary_image وimages[].url يُرجعان روابط CDN كاملة بدل أسماء الملفات المجرّدة. إذا كان كودك يضيف البادئة يدويًا فاحذف ذلك المنطق.

✨ POST /v1/orders — إنشاء الطلبات عبر الواجهة البرمجية. مصمَّم للثيمات المخصصة والمتاجر بدون رأس وتطبيقات الجوال وأتمتة الموزّعين. تسعير سطور الطلب معتمد على الخادم؛ دعم كامل للمتغيرات؛ idempotent.

📚 دليل جديد: الثيمات والواجهات المخصصة — بناء كامل من العرض إلى السلة إلى الـ checkout والـ webhooks.

📚 دليل جديد: للموزّعين — إدارة متاجر متعددة للعملاء، عمليات بالجملة، علامة بيضاء، نماذج فوترة.

📚 دليل جديد: إعداد البيئة و .env — تخزين آمن لبيانات الاعتماد عبر Node, Python, PHP, Go, Vercel, Cloudflare, AWS, Docker/K8s, GitHub Actions.

📚 توسيع مرجع Orders — توثيق كامل للمتغيرات بما في ذلك المخزون لكل متغيّر، المخزون لكل تركيبة، المتغيرات المتدرجة، متغيرات الصورة-نص، عروض القطع المتعددة.

🎉 إطلاق نسخة تجريبية أولى.

مصادقة وحد معدل وذاكرة قراءة مؤقتة، لكل مفتاح.

نقاط نهاية قراءة للمتجر / المنتجات / الطلبات / العملاء / صفحات الهبوط.

نقاط نهاية كتابة مع idempotency للمنتجات / الطلبات / صفحات الهبوط.

استيعاب غير متزامن لـ/v1/signups و /v1/events (202 Accepted).

Webhooks صادرة مع إعادة محاولة تلقائية.