ملخص تحديثات المطورين: الجديد في زد للشركاء

تغييران إلزاميان موعدهما 30 سبتمبر 2026

أُعلن في يونيو على سجل تحديثات الشركاء عن تغييرين موعدهما واحد: 30 سبتمبر 2026. تأكد منهما قبل أي شيء آخر.

1. إيقاف GET v1/managers/profile: انتقل إلى واجهات Account API الجديدة، ولكل واجهة منها صلاحية OAuth مستقلة: Account Identity وAccount Profile، إضافة إلى واجهات المتجر للتفاصيل والهوية والتوطين والحسابات الاجتماعية والتشغيل والبيانات التجارية.
2. Basic Authentication إلزامية للـ Webhooks: أرسل username وpassword عند إنشاء أي Webhook أو تحديثه. بعدها ترسل زد Header Authorization: Basic مع كل إرسال، فيتحقق الـ Server الخاص بك من أن الطلب قادم من زد فعلًا.

APIs جديدة وموسّعة

• واجهات المحفظة (8 سبتمبر 2026): 16 endpoint جديدة في ثلاثة مجالات: قواعد الكاش باك (5)، وتحليلات المحفظة (2)، وإدارة محفظة العميل (9)، وتشمل الأرصدة والعمليات والكاش باك المعلّق والإضافة والخصم والتصدير.
• Blogs API (22 يوليو 2026): إصدار v2 فيه 41 endpoint لإدارة مدونة المتجر بالكامل: الإعدادات والتصنيفات والمقالات والوسائط والوسوم، إضافة إلى قراءات لواجهة المتجر. ويدعم العمليات الجماعية واستيراد المحتوى وتصديره والجدولة عبر scheduled_at.
• مصدر الطلب (12 يوليو 2026): أصبح رد View Order يتضمن Object اختياريًا اسمه marketing_channel_source، فيه visit_source وcampaign_name وreferrer_link وdevice_type وbrowser وoperating_system. كل حقل فيه قد تكون قيمته null، ولم يتغير أي حقل موجود.

Webhooks أكثر موثوقية وحدود طلبات أوضح

مع Webhook Health Tracking (28 يونيو 2026) صار لكل Webhook حقل health_status بإحدى ثلاث قيم: healthy أو degraded أو broken، بحسب عدد مرات الفشل خلال آخر ساعة:

• degraded: عشر مرات فشل أو أكثر خلال الساعة الأخيرة. يستمر الإرسال، لكن عليك أن تتحقق من السبب.
• broken: ثلاثون مرة فشل أو أكثر خلال الساعة الأخيرة. يتوقف الإرسال حتى تستعيد الـ Webhook برابط جديد، ولا يُقبل الرابط نفسه.
• يُعاد إرسال كل حدث حتى 3 مرات (بعد دقيقة، ثم 5 دقائق، ثم 15 دقيقة) قبل أن يُحسب فشلًا، ولا تُحسب ردود HTTP 429 فشلًا أصلًا.
• ثلاث endpoints جديدة: ملخص الحالة، وقائمة الـ Webhooks المتوقفة، واستعادة المتوقف منها.

وفي اليوم نفسه حُدد سقف الطلبات بـ 60 طلبًا في الدقيقة لكل تطبيق في كل متجر، مع خوارزمية Leaky Bucket لإدارة الطلبات. ولمتابعة الحالات، توصي زد باستخدام Webhooks بدل الاستعلام المتكرر.

تغييرات في سوق التطبيقات

• حتى 8 باقات اشتراك لكل تطبيق (يونيو 2026) بدلًا من 4، أي أربعة مستويات لكل منها خيار شهري وآخر سنوي.
• قناة دعم داخل التطبيق (14 يوليو 2026): على كل تطبيق أن يتضمن قناة دعم ظاهرة وفعّالة داخل التطبيق نفسه: محادثة مباشرة، أو نموذج دعم، أو رابط مباشر لنظام تذاكر. ومنذ 17 يوليو 2026 يُرفض أي تطبيق يدخل المراجعة من دونها.

لمطوري الثيمات

• العلامات التجارية (15 سبتمبر 2026): استخدم brands.jinja لصفحة /brands، وbrand.jinja لصفحة علامة تجارية واحدة. كما أصبح product.jinja يعرض product.brand.name وproduct.brand.logo.
• خصومات البنوك (20 أغسطس 2026، إجراء مطلوب): أضِف {% include 'vitrin:shared/bank_discounts.jinja' %} إلى صفحتي تفاصيل المنتج والسلة، وإلا فلن تظهر فيهما خصومات البنوك التي يضبطها التاجر. ولا تحتاج صفحة الدفع إلى أي تعديل في الثيم.
• إظهار حقل الكوبون (19 أغسطس 2026): صار بإمكان التاجر إخفاء حقل الكوبون. تحقّق من store.settings.checkout.is_coupon_form_enabled، ولا تُخفِ قسم الكوبون كاملًا إلا إذا كانت القيمة false صراحة.

متاح الآن في التوثيق

هذه الأدلة لا تحمل تاريخ إطلاق، لكنها منشورة الآن على docs.zid.sa وتستحق أن تطّلع عليها:

• Zid AI Agent Skill: مهارة مفتوحة المصدر تساعد Claude وClaude Code وopencode وغيرها على بناء تكاملات زد بالطريقة الصحيحة في OAuth وتعدد المتاجر ومعالجة الأخطاء. أُعلن عنها في 8 سبتمبر 2026.
• Our custom MCP server: اربط Cursor أو VS Code مع Cline بتوثيق APIs زد.
• Embedded Apps: شغّل تطبيقك داخل لوحة تحكم التاجر باتباع خطوات الـ Authentication الست.
• Zid MUI وZid SDKs: مكوّنات واجهة منسجمة مع اللوحة، وSDK للغة Python، مع Laravel وTypeScript قريبًا بحسب التوثيق.