أضافت Shopify في 16 نوفمبر 2026 خياراً داخل Dev Dashboard يسمح بتفعيل فحص انتهاء صلاحية رموز Admin API قبل موعد الإلزام للتطبيقات العامة القائمة في 1 أبريل 2027. أهميته ليست زر إعداد جديداً، بل فرصة لفريق التطوير لاكتشاف المهام الخلفية والتكاملات التي ما زالت تعتمد على رمز وصول غير منتهٍ. لا يعني تشغيل الخيار ترحيل الرموز تلقائياً أو إلغاء الرموز الموجودة، ولذلك يجب التعامل معه كاختبار تشغيلي مخطط له لا كحل فوري للمصادقة.
ماذا يفعل خيار token expiry؟
عند تفعيله على مستوى التطبيق، يشمل الاختبار جميع المتاجر المثبت لديها ذلك التطبيق. قد ترفض طلبات GraphQL وREST Admin API التي تستخدم offline access token غير منتهٍ، وكذلك delegate access token المتبقي على انتهائه أكثر من 24 ساعة. يذكر الإعلان أن تطبيق السياسة قد يستغرق حتى ثلاثين دقيقة. ويمكن إيقاف الخيار إذا ظهرت مشكلات، لكن ذلك لا يغير تاريخ الإلزام للتطبيقات العامة. الموعد المعلن لا ينطبق بالطريقة نفسها على التطبيقات المخصصة والتطبيقات المنشأة من التاجر، وإن كان الاختبار متاحاً لها.
جهز خريطة الرموز قبل الضغط على الزر
ابدأ بجرد طرق المصادقة في التطبيق: تثبيت المتجر، جلسات المستخدمين، معالجة webhooks، إنشاء المنتجات، الجرد، مزامنة الطلبات، الاشتراكات والمهام المجدولة. دوّن أي عامل يستخدم رمزاً محفوظاً منذ مدة طويلة، ومكان تخزينه، وطريقة تجديده، ومسؤولية التعامل مع فشل 401 أو أخطاء GraphQL المتعلقة بالتصريح. لا تطبع قيمة الرمز في السجلات ولا تضعها في ملفات JSON أو مستودع Git. يجب أن يظل مخزن الرموز مشفراً ومحدود الوصول مع آلية تدوير قابلة للمراجعة.

خطة ترحيل واختبار على مراحل
1. نفذ ترحيل الرموز حسب الدليل الرسمي
راجع دليل Shopify المخصص للانتقال إلى expiring offline access tokens، ثم طبق تدفق التجديد الذي ينطبق على نوع تطبيقك. لا تفترض أن إعادة تحميل صفحة التاجر ستجدد رمز العامل الخلفي؛ فالمهام المجدولة قد تعمل دون جلسة تفاعلية. اختبر انتهاء الصلاحية وتجديدها على متجر تطوير أولاً، مع حالات توقف الشبكة، والاستدعاءات المتزامنة التي قد تحاول تجديد الرمز نفسه في الوقت ذاته. استخدم قفلاً أو آلية تنسيق تمنع تعارض التجديد إن كان تصميم التخزين يتطلب ذلك.
2. فعّل الاختبار في Dev Dashboard
بعد مراجعة المسارات الحساسة، افتح إعدادات التطبيق وابحث عن بطاقة Admin API token expiry ثم اختر التفعيل مع فهم تأثيره على جميع المتاجر. انتظر مدة سريان الإعداد التي قد تبلغ ثلاثين دقيقة قبل الحكم على النتائج. نفذ اختبارات قراءة وكتابة محدودة في بيئة مصرح بها، ولا تستخدم عمليات مالية أو حذفاً جماعياً في أول محاولة. راقب مؤشرات فشل المصادقة ونسب التجديد الناجح وعدد المهام التي توقفت عن التقدم.
3. اختبر الإخفاق والعودة الآمنة
تعمد استخدام رمز اختباري غير متوافق، وتحقق من أن التطبيق يعيد المصادقة أو يوقف المهمة برسالة قابلة للتشخيص بدلاً من تكرار الطلب بلا نهاية. اختبر استقبال webhook وإعادة المعالجة دون إنشاء طلبات مكررة. وإذا لزم التراجع، عطّل خيار الاختبار وحدد سبب الفشل وسجل خطة إصلاح قبل المحاولة مجدداً؛ فإيقاف الاختبار لا يغني عن الاستعداد للموعد المحدد. راجع لوحة Dev Dashboard التي تشير إلى مشكلات محتملة خلال آخر أربعة عشر يوماً، مع الانتباه إلى تأخر ظهور بعض المؤشرات.
كيف تعرف أنك جاهز فعلاً؟
لا تعتبر نجاح طلب API واحد دليلاً كافياً. معيار القبول هو استمرار مهام الطلبات والمخزون والدفع في العمل بعد دورة انتهاء وتجديد فعلية، مع حفظ معرفات العمليات لمنع التكرار وإشعارات واضحة عند فشل استعادة الاعتماد. ضع إنذاراً على ارتفاع 401 وأخطاء التصريح، وراجع السجلات دون تعريض أسرار. التاريخ مهم، لكن النتيجة الأهم هي أن تطبيق Shopify لا يتوقف عند انتهاء الرمز ولا يمنح نفسه وصولاً أكبر مما يحتاج.
0 Responses
Share your perspective and continue the conversation.
No responses yet
Be the first to share your thoughts.
Join the conversation