مقدمة

يُبلغ نظام التكامل المقترح مع المتصفح عن خطأ CORS عند طلب استجابة من خدمة المشغل. ويستنتج فريق المشروع أن الخادم لم يستلم أي بيانات. في هذا السيناريو الافتراضي، خلط النظام بين قدرة المتصفح على عرض الاستجابة وتسليم الطلب. هذا التمييز مهم عند تقييم التكامل الفعلي ونقاط ضعفه.

دليل مشاركة الموارد عبر المصادر من MDNيصف التقرير، الذي قُرئ في 11 أكتوبر 2026، آلية ترويسة HTTP للسماح للمتصفح بالوصول من مصادر أخرى. كما يوضح أن بعض الطلبات تُرسل دون فحص مسبق، ومع ذلك فهي لا تزال بحاجة إلى إذن الخادم قبل مشاركة الاستجابة مع البرنامج النصي الطالب. لذا، فإن خطأ المتصفح وحده لا يُحدد ما حدث على الخادم.

يتناول هذا الدليل تكاملًا مُقترحًا عبر المتصفح لعمليات البيع الآلي. ويطرح أسئلة حول نطاق التطبيق والأدلة المطلوبة؛ ولا يستدعي واجهة برمجة تطبيقات، ولا يُغيّر رؤوس الاستجابة، ولا يُرسل بيانات اعتماد عبر النطاقات. ويتعين على المزوّد المسؤول إثبات الحالات المتفق عليها في بيئة مُراقبة.

تُشكّل قوائم WEIMI الثلاثة الأصلية أدناه قائمة مختصرة للأجهزة بناءً على بيانات الشركات المصنّعة المتاحة للعموم. ولا تُثبت هذه القوائم أي تكامل مُحدد عبر النطاقات أو سياسة CORS الخاصة بها. يُرجى التأكد من الخدمات الفعلية المُدرجة في عرض الأسعار قبل إضافة أي شرط للوصول عبر المتصفح.

إجابة سريعة

سجل النتائج الثلاث بشكل منفصل: تسليم الطلب، ورؤية الاستجابة لبرنامج المتصفح النصي، وقرار العمل الخاص بالخادم.يتعلق نظام CORS بالوصول من مصادر مختلفة عبر المتصفحات. ولا ينبغي استخدامه كبديل لمصادقة المشغل، أو أذونات السجلات، أو الحماية من تغييرات الحالة غير المرغوب فيها.

حدد مصدر الطلب والخدمة المستهدفة، وطريقة الطلب الفعلية وعناوينها، وما إذا كانت بيانات الاعتماد مطلوبة. يصف MDN المصادر من حيث النطاق والبروتوكول والمنفذ. اسم التطبيق المعتمد وحده لا يمثل سياسة مصدر دقيقة.

بالنسبة لطلبات المتصفح المعتمدة، يتطلب الدليل تحديد مصدر مسموح به صراحةً بدلاً من استخدام رمز البدل Access-Control-Allow-Origin. تظل سياسات ملفات تعريف الارتباط سارية حتى في حال سماح استجابة CORS بالوصول المعتمد. اطلب دليلاً باستخدام بيئة المتصفح المدعومة فعلياً بدلاً من قبول ادعاء عام بنجاح التكامل.

جدول المقارنة

تختلف معاني هذه الأدلة. يجب أن تبقى عمليات التحقق المقترحة ضمن بيئة الاختبار الخاصة بالمزود المعتمد والتكامل الفعلي المقدم.

من ينبغي عليه شراء هذا المنتج؟

استخدم هذا الموجز عندما يُقدّم المورّد تطبيقًا للمشغل يقرأ خدمة من مصدر مختلف عبر واجهات برمجة تطبيقات المتصفح، مثل fetch أو XMLHttpRequest. تأكد من وجود التكامل وحدّد نطاقه. لا تُنشئ ميزة السحابة أو المخزون واجهة برمجة تطبيقات عامة أو وصولًا عبر المتصفح من مصادر مختلفة.

ينبغي على مالك التطبيق تحديد مصدر الطلب والاستخدام المقصود. كما ينبغي على مزود الخدمة المستهدفة تحديد سياسة الوصول وصلاحيات الخادم. وعلى مالك النشر تأكيد العملاء المدعومين وسلوك ملفات تعريف الارتباط. وينبغي على قسم المشتريات التوفيق بين هذه المسؤوليات بدلاً من مطالبة مورد واحد بالموافقة على كل نطاق.

يُعدّ هذا الدليل مفيدًا عندما يعمل التكامل بنجاح في عرض توضيحي واحد، ولكنه يفشل بعد تغيير اسم المضيف أو البروتوكول أو المنفذ أو سياسة المتصفح. كما يُفيد أيضًا عندما يصل طلب إلى الخادم، ولكن لا ترى واجهة المستخدم سوى خطأ. احتفظ بنتيجة الفشل التي تظهر للمستخدم ونتيجة الخادم قابلة للمراجعة بشكل منفصل.

كيف نقوم بتقييم آلات البيع الذكية

راجعنا بيانات المنتجات العامة المحفوظة للمرشحين الثلاثة لمنصة WEIMI بتاريخ 10 أكتوبر 2026. وقارنّا بين صيغ البيع بالتجزئة وأسئلة تأكيد الطلب. لم نرصد أي تكامل بين المشغلين عبر المصادر، أو سياسة ملفات تعريف الارتباط، أو استجابة CORS لأي مرشح. هذه قائمة مختصرة عامة، وليست اختبارًا مستقلًا.

أولًا، حدد التكامل الفعلي. سجّل مصدر التطبيق ومصدر الخدمة المستهدفة، والغرض التجاري، ومزود البرامج المُضمّنة. إذا لم يكن للعرض آلية عمل متصفحات متعددة المصادر، فلا تُنشئ آليةً لتطبيق هذا الموجز. يحتاج تبادل البيانات بين الخوادم إلى تقييم خاص به بدلًا من مجرد عرض توضيحي لـ CORS عبر المتصفح.

ثانيًا، حدد خصائص الطلب. يمكن أن تؤثر طريقة الإرسال، والعناوين، ونوع المحتوى، ونمط بيانات الاعتماد على معالجة ما قبل الإرسال والاستجابة. اطلب من المزوّد وصفًا للتنفيذ الفعلي بشكل آمن. لا يحتاج المشتري إلى ملفات تعريف ارتباط حقيقية أو رموز حساب لتسجيل هذا النطاق.

ثالثًا، اتفق على أدلة النتائج. بالنسبة للمصدر المعتمد، راقب الاستجابة المقروءة المتوقعة ونتيجة تفويض الخادم. أما بالنسبة لمصدر اختبار غير معتمد، فحدد رفض الوصول المتوقع من المتصفح دون افتراض عدم تسليم الطلب. يجب على المزود استخدام بيانات اختبار غير ضارة وشرح النتيجة.

أخيرًا، راجع تغييرات النشر. يجب أن تعكس قائمة المصادر المسموح بها بيئة التطبيق المعتمدة فعليًا. تُعد المتصفحات المدعومة وسياسات ملفات تعريف الارتباط جزءًا من الأدلة الوظيفية. لا تُغطي لقطة الشاشة من مصدر أو عميل مختلف عملية النشر النهائية تلقائيًا.

عوامل الشراء الرئيسية

الأصل أدق من اسم العلامة التجارية.يصف MDN المصدر باستخدام المخطط والنطاق والمنفذ. حدد الصفحة والمورد الأصليين للطلب في سجل الأدلة. لا ينبغي أن تصبح صلاحيات مضيف الإنتاج ومضيف العرض التوضيحي قابلة للتبادل تلقائيًا.

لا يتم فحص كل طلب مسبقًا.يصف المصدر الطلبات البسيطة المؤهلة التي لا تتطلب فحصًا مسبقًا. مع ذلك، لا يزال يتعين على الخادم الموافقة قبل مشاركة الاستجابة مع البرنامج النصي. استفسر عن الطلبات الفعلية التي تُرسل مباشرةً وتلك التي تتطلب الفحص الأولي؛ ولا تستنتج مسار العملية من وجود علامة API.

الفحص المسبق للرحلة ليس معاملة تجارية.يمكن للمتصفح أن يستعلم من الخادم المستهدف عن الطريقة المقصودة وعناوين الاستجابة قبل إرسال الطلب الفعلي. لا يُعدّ تبادل بيانات OPTIONS بنجاح دليلاً على نجاح العملية أو الاستجابة النهائية. يجب أن يتضمن القبول سير العمل المسموح به فعلياً ونتيجته على الخادم.

يتطلب وضع بيانات الاعتماد نطاقًا محددًا.يشير الدليل إلى أن جلب البيانات من مصادر مختلفة وطلب XMLHttpRequest لا يرسلان بيانات الاعتماد افتراضيًا. يمكن للتطبيق طلب تضمين بيانات الاعتماد، مع تحديد متطلبات الخادم المناسبة. استفسر عما إذا كانت آلية العمل المُقدمة تتطلب بيانات اعتماد، وكيف تتعامل مع سياسة المتصفحات المدعومة.

لا يمكن استخدام رمز البدل الخاص بالأصل للوصول المعتمد.تنصّ MDN على ضرورة أن يُحدّد Access-Control-Allow-Origin مصدرًا صريحًا للاستجابات المعتمدة. لا يجوز نسخ رمز عام يعمل مع مورد عام غير معتمد إلى متطلبات بيانات المشغل. يجب على المزوّد تحديد مجموعة المصادر المعتمدة وإثبات الوضع الفعلي.

سياسة ملفات تعريف الارتباط لا تزال سارية.يشير المصدر إلى أن سياسات ملفات تعريف الارتباط الخاصة بأطراف ثالثة قد تمنع إرسال ملفات تعريف الارتباط أو تخزينها حتى مع وجود إذن بالوصول إلى CORS باستخدام بيانات اعتماد. اطلب دليلًا على ذلك للعملاء المدعومين. لا يمكن لرأس CORS وحده تجاوز جميع سياسات خصوصية المتصفح.

تتطلب الاستجابات الديناميكية للمصدر وعيًا بذاكرة التخزين المؤقت.توصي MDN باستخدام Vary: Origin عندما يكون المصدر المسموح به واحدًا وقد يتغير وفقًا للطلب وقائمة المصادر المسموح بها. استفسر من مزود الخدمة عن كيفية حفاظ استجابته وترتيب ذاكرة التخزين المؤقت على السياسة المقصودة. لا تتناول هذه المقالة أي تكوين فعلي لذاكرة التخزين المؤقت.

إن منع المتصفح لا يوفر حماية كاملة للخادم.يشرح موقع MDN سبب إمكانية إرسال طلبات بسيطة من مصادر مختلفة كأي نماذج عادية، وسبب حاجة الخوادم إلى حماية من هجمات تزوير الطلبات عبر المواقع (CSRF). يجب فصل حماية تغيير الحالة وتفويض الخادم عن إذن مشاركة الاستجابة. لا يُثبت خطأ CORS استحالة تنفيذ عملية غير مرغوب فيها.

يتطلب تحديد تفاصيل الخطأ تشخيصًا آمنًا.يوضح الدليل أن جافا سكريبت لا ترى سوى حدوث خطأ CORS، بينما تساعد تفاصيل وحدة تحكم المتصفح في تحديد السبب. اطلب دليلًا من مزود الخدمة مع إخفاء المعلومات الحساسة، بالإضافة إلى نتيجة الخادم. لا تطلب من المشغلين لصق بيانات الاعتماد أو الردود الخاصة الكاملة في موضوع دعم عام.

أفضل آلات البيع الذكية

تُقدّم هذه القوائم الثلاث الحقيقية تكوينات بيع بالتجزئة مختلفة للمنتجات المُغلّفة. ولا تُشير خصائصها العامة إلى أي تكامل مع المتصفحات أو أذونات واجهة برمجة التطبيقات (API). اطلب عرض الخدمة المتصلة الفعلي والأدلة من مزوّدها المسؤول.

مقارنة الميزات

يتطلب اختيار الأجهزة وقبول تكامل المتصفح أدلة منفصلة. استخدم الصيغة العامة لتحديد نطاق عرض البيع بالتجزئة، ثم حدد ما إذا كان البرنامج المذكور يحتاج إلى الوصول إلى الاستجابة من مصادر متعددة أم لا.

تحليل التكلفة والعائد على الاستثمار

بدل القبول الافتراضي:بافتراض 50 دقيقة لمطابقة بيانات المصدر وسجل الطلبات، و45 دقيقة لمراجعة بيانات المتصفح التي يتحكم بها مزود الخدمة، و40 دقيقة لتسجيل قيود العميل المدعوم، فإن المجموع 135 دقيقة، أي ساعتان وربع. وبافتراض أن تكلفة الساعة 39 دولارًا أمريكيًا، فإن تكلفة العمالة الداخلية 87.75 دولارًا أمريكيًا.

لنفترض أن تغيير اسم المضيف لاحقًا يتطلب مراجعة لمدة 30 دقيقة بنفس السعر، بتكلفة 19.50 دولارًا أمريكيًا. يبلغ إجمالي المبلغ المخصص للتوضيح 107.25 دولارًا أمريكيًا. هذه افتراضات تخطيطية افتراضية، وليست جهد تكامل فعلي، أو رسوم WEIMI، أو عرض أسعار لاختبار احترافي.

لا يشمل هذا المبلغ تكاليف التنفيذ، وتغييرات الاستضافة، والتقييم المتخصص. يُرجى الحصول على نطاق الخدمة الفعلي والأسعار. لا يُحدد هذا المثال أي قيمة للحوادث التي تم تجنبها، ولا يتوقع أي تحسن في المبيعات، ولا يُحدد فترة استرداد تكلفة المعدات.

قارن بين العروض المقدمة من جهات التكامل الفعلية، والعملاء الذين تم دعمهم، والمسؤولية عن الأعمال غير المنجزة. لا يُعد نجاح نظام CORS مقياسًا لعائد الاستثمار التجاري. فإيرادات التجزئة لا تزال تتطلب الطلب الفعلي على الموقع، وهوامش الربح، وتكاليف إعادة التموين، وتكاليف الخدمة.

الخيار الأفضل حسب السيناريو

يُقدَّم مورد عام غير معتمد:استفسر عن الجهات التي يُسمح لها بالاطلاع على هذه السياسة، وما إذا كان نطاقها يتوافق مع الاستخدام المقصود. لا تنقل هذه السياسة تلقائيًا إلى معلومات خاصة بالمشغل تتطلب بيانات اعتماد.

بوابة معتمدة تقرأ نطاقًا آخر:اطلب تحديد المصدر المسموح به صراحةً، ووضع بيانات الاعتماد، وسياسة ملفات تعريف الارتباط للمتصفحات المدعومة. حدد كلاً من الاستجابة المقروءة وأذونات الخادم. لا يغني أحدهما عن الآخر.

يظهر خطأ CORS بعد الطلب:اطلب من مزود الخدمة فحص سجلات تشخيص المتصفح الآمن وسجلات الخادم. سجّل ما إذا كان الطلب قد وصل وما إذا تم تنفيذ إجراء تجاري. لا تفسر الخطأ على أنه دليل قاطع على عدم حدوث أي شيء.

يتم نقل التكامل إلى مضيف أو منفذ جديد:أعد فتح سجل المصدر وسياسة الاستجابة ذات الصلة. يمكن الآن أن يكون للتطبيق نفسه مصدر مختلف. اطلب دليلاً على النشر النهائي المقترح.

تنجح عملية الفحص المسبق للرحلة، لكن المهمة تفشل:ميّز بين إذن الطريقة/الترويسة المبدئي والطلب الفعلي وبيانات الاعتماد والنتيجة التجارية. دع المزوّد يحدد السبب باستخدام التشخيصات المعتمدة بدلاً من توسيع نطاق سياسة المصدر دون مراجعة.

التطبيقات

أنشئ سجلًا لتكامل المتصفح يتضمن مصدر التطبيق، ومصدر الهدف، والغرض، والطريقة، والعناوين، ووضع بيانات الاعتماد، وتوقعات ما قبل الرحلة، ومالك أذونات الخادم، والعملاء المدعومين. هذا سجل مقترح للشراء، وليس وظيفة مُنفذة من وظائف WEIMI. أدرج فقط عمليات التكامل الفعلية المُقدمة.

اتفق على إجراء عرض توضيحي مُحكم باستخدام بيانات اختبار غير ضارة. يجب على المزوّد تحديد القراءة المقصودة من مصدر معتمد، والرفض الموثق من مصدر اختبار غير معتمد. سجّل نتيجة الخادم بشكل منفصل. لا يجوز للمشتري إرسال طلبات استكشافية إلى خدمة الإنتاج.

احتفظ بسجلات آمنة لعملية النشر الفعلية وبيئة المتصفح. قم بإخفاء رموز الحساب وملفات تعريف الارتباط وبيانات الاستجابة الخاصة. اجعل نتيجة قراءة الاستجابة ونتيجة التفويض مرتبطتين ولكن منفصلتين حتى يفهم المراجعون اللاحقون ما تم التحقق منه.

عند تغيير المصادر أو أنماط بيانات الاعتماد أو المتصفحات المدعومة، أعد فتح عناصر القبول ذات الصلة. حافظ على آلية تسليم واضحة للمزود في حالة حدوث أعطال. قم بتشغيل نظام معالجة الطرود والتبريد والبيع بالتجزئة الخاص بالخزانة بشكل منفصل حتى الوصول إلى التكوين النهائي المطلوب.

التعليمات

التوصية النهائية

تأكد من تكامل المتصفح بدقة، مع تحديد المصادر ووضع بيانات الاعتماد. تحقق من قراءة الاستجابة، وتسليم الطلب، وقرار الخادم التجاري كنتائج منفصلة. توضح إرشادات MDN الخاصة بـ CORS لماذا لا يمكن لخطأ واحد أو نجاح واحد أن يحل جميع المشاكل الثلاث.

اختر صيغة البيع باستخدام المعلومات المتاحة للجمهور وتجارب الحزم الفعلية. اطلب أدلة برمجية خاصة بالنشر من المزوّد المسؤول قبل البدء. لا تتضمن هذه المقالة أي استدعاء لواجهة برمجة التطبيقات، ولا تُغيّر أي سياسة مصدر، ولا تُصدّق على أي تكامل للقائمة المختصرة.