BIGCOMMERCE · SKU-MD v1.0.0-beta

انشر الحد الأدنى من المستند الجذري أولاً، ثم أضف المعرفة ذات المصدر عند الحاجة

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

افتح مولد BigCommerce

من دون بيانات اعتماد · من دون واجهات API خاصة · من دون زحف جماعي · من دون نشر تلقائي

يدير BigCommerce التجارة المباشرة؛ يحمل SKU-MD معرفة تمت مراجعتها

يحافظ التكامل على المعاملات الديناميكية والمعرفة الدائمة بالمنتج في الأنظمة التي يمكنها دعمها فعليًا.

BIGCOMMERCE

المرجع المعتمد للتجارة الحالية

هو المرجع المعتمد للمنتجات الحالية والمتغيرات وتسعير القنوات والمخزون والمتسوقين وسلة التسوق والطلبات وسلوك إتمام الشراء.

SKU-MD

عقد المستند العام الأدنى

ينشر جذر v1 في /sku.md، ويضيف مستند معرفة اختياريًا واحدًا للمنتج مرتبطًا بـ Source عند الحاجة.

يستخدم المولد الحالي الأدلة العامة فقط

يستخدم هذا التدفق المدخلات العامة والملفات المنشأة محليًا فقط.

01
أدخل عنوان URL عامًا
قدّم واجهة متجر عامة أو كتالوجًا عامًا، أو صفحة منتج عامة واحدة.
02
أنشئ الحد الأدنى من الجذر
أنشئ جذر v1 وتحقق منه قبل إضافة أي مستند اختياري.
03
أضف المعرفة ذات المصدر فقط
يمكنك إنشاء مستند معرفة اختياري واحد للمنتج مرتبط بـ Source من صفحة المنتج المحددة صراحة.
04
النشر والتحقق
انشر /sku.md، ثم نفّذ عمليات التحقق document وpublished وgraph.

تعمل إمكانيات BigCommerce على حل أجزاء مختلفة من دورة الحياة

هذه هي أسطح BigCommerce الموثقة. إدراجهم لا يعني أن المولد العام الحالي يستدعيهم.

عام

واجهة المتجر أو الكتالوج أو صفحة المنتج

يقرأ المولد عنوان URL العام الذي أدخله المستخدم فقط، ولا يستنتج منتجات أخرى ولا يزحف إلى الكتالوج.

واجهة المتجر

GraphQL Storefront API

يستعلم عن المنتجات المرئية والمتغيرات والأسعار وmetafields الخاصة بواجهة المتجر والمسارات والمحتوى. تتطلب الطلبات bearer token مناسبًا، بينما لا يقبل المولد الحالي أي token.

الإدارة

REST Management API

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

مصادقة

حسابات API وOAuth

تتمتع الحسابات على مستوى المتجر والتطبيق بإمكانية الوصول إلى نطاقات token وOAuth. تبقى الأسرار من جانب الخادم ويتطلب أقل قدر من الامتيازات.

الأحداث

Webhooks

يمكن لتسليم HTTPS أو Pub/Sub أو EventBridge تشغيل تحديثات تدريجية. وتظل أجهزة الاستقبال بحاجة إلى المصادقة والمعالجة idempotent وإدارة إعادة المحاولة والتسوية.

واجهة المستخدم في المتجر

Scripts API

يمكن للتطبيقات المعتمدة إضافة نصوص برمجية لواجهة المتجر تراعي القناة. يمكن أن تعلن البرامج النصية عن روابط الاكتشاف، ولكن التعليمات البرمجية من جانب العميل ليست استجابة Markdown المطلوبة.

التسليم

واجهات متاجر Stencil وheadless

تُسند قوالب Stencil المخصصة إلى أنواع الصفحات الموجودة. ويمكن لطبقة headless أو edge يتحكم فيها التاجر تنفيذ مسار مستند دقيق على same-origin.

لا توثق المصادر الرسمية التي تمت مراجعتها اعتماد BigCommerce لـ SKU-MD. وتظل قدرة المنصة والاكتشاف المتوافق والمطابقة الصارمة والمرجعية المباشرة ادعاءات منفصلة.

اختر التسليم حسب الرد الذي يمكنك إثباته

إن Markdown الذي تم إنشاؤه هو نفسه في كل وضع. يحدد المسار المنشور فقط ما إذا كان النشر متوافقًا أم صارمًا.

الاكتشاف

واجهة متجر Stencil

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

تعرض قوالب Stencil أنواع صفحات واجهة المتجر الحالية؛ يقوم Scripts API بتثبيت البرامج النصية. ولا يثبت أي منهما بمفرده استجابة text/markdown لمسار الجذر.

مرشح صارم

مسار headless يتحكم فيه التاجر

قم بخدمة الملفات غير القابلة للتغيير والتي تم التحقق من صحتها مسبقًا من تطبيق واجهة المتجر مع الاحتفاظ بروابط canonical وparent من نفس المصدر.

يتطلب HTTP 200 دقيقًا وContent-Type: text/markdown وهوية البايت ورسمًا صالحًا للمستند واستبدالًا متوقعًا لذاكرة التخزين المؤقت واستجابة 404 دقيقة للملفات غير المعروفة.

مرشح صارم

مسار edge على same-origin

قم بتقديم المستندات المخزنة على /sku.md ومسارات مستندات المنتج قبل أن تصل الطلبات إلى واجهة المتجر المستضافة.

قاعدة التوجيه ليست دليلاً. تحقق من الاستجابة الحقيقية بعد كل تغيير في النشر.

الوضع	ماذا يمكن أن تفعل	حد الأدلة
Stencil	استخدم قالب متجر أو صفحة مخصصة أو تكامل Scripts API لعرض إرشادات الاكتشاف.	الاكتشاف المتوافق فقط؛ لا تنشئ الأسطح الموثقة استجابة Markdown تعسفية لمسار الجذر.
headless	قم بتقديم الملفات المقبولة من تطبيق واجهة المتجر الذي يتحكم فيه التاجر على أصل المتجر.	صارم فقط بعد مرور المسار الدقيق ونوع الوسائط والبايتات والرسم البياني واستبدال ذاكرة التخزين المؤقت وسلوك 404.
edge	اعتراض مسارات مستند same-origin قبل واجهة المتجر المستضافة وإرجاع وحدات البايت المقبولة المخزنة.	لا تثبت المطابقة الصارمة إلا بعد التحقق من الاستجابة العامة بصورة مستقلة عن الإعدادات.

حافظ على الحد الأدنى لعائلة مستندات v1

يستخدم المولد المخصص أدوات بناء v1 والمدقق نفسيهما في التدفق العام.

الجذر الأدنى أولاً

أنشئ جذر v1 بهوية المتجر العامة ونقطة دخول الكتالوج.

مستند منتج اختياري واحد

أضف معرفة المنتج لصفحة منتج عامة واحدة فقط يحددها المستخدم صراحة.

حقائق مرتبطة بـ Source

ترتبط كل حقيقة بـ Source عام، ويتحقق مدقق graph من علاقات المستندات.

نطاق محافظ

إذا لم تتوفر معرفة منتج ذات مصدر، فاحتفظ بالجذر الصالح ولا تنشئ المستند الاختياري.

تحقق من كل نطاق نشر

الإنشاء والنشر خطوتان منفصلتان، لذلك يحتاج كل نطاق إلى دليل مستقل.

document
تحقق من البايتات المنشأة
شغّل مدقق مستند v1 الحالي قبل النشر.
published
تحقق من الاستجابة العامة
تحقق من حالة استجابة /sku.md الحقيقية ونوع MIME والبايتات.
graph
تحقق من العلاقات
تحقق من كل مستند مشار إليه وعلاقة Source.
تكرار
أعد التحقق بعد التغيير
أعد تشغيل جميع النطاقات عند تغيير الملفات المنشورة.

لا يتصل التدفق الحالي بحسابات BigCommerce ولا ينشر الملفات تلقائيًا.

أذونات وحدود الإصدار الحالي

يظل سير العمل العام ضيقًا وقابلاً للتفتيش ويسيطر عليه التجار.

لا يوجد تسجيل دخول لـ BigCommerce، أو حساب API، أو تدفق OAuth، أو الوصول إلى token، أو واجهة المتجر token، أو token الخاص.
لا يوجد طلب REST Management API أو GraphQL Storefront API ولا يوجد أي زحف إلى الكتالوج.
لا يوجد وصول إلى الطلبات أو العملاء أو سلات التسوق أو إتمام الشراء أو المدفوعات أو المنتجات الخاصة.
لا اشتراك في Webhook، ولا مزامنة في الخلفية، ولا تعديل لقالب المتجر، ولا تثبيت للبرامج النصية، ولا تحديث تلقائي.
لا تغيير في DNS أو الوكيل أو edge أو ذاكرة التخزين المؤقت أو إعدادات النشر إلى بيئة الإنتاج.
لا توجد مطالبة بتأييد BigCommerce أو الشراكة أو دعم SKU-MD الرسمي أو مزايا التبني.

من منظور العلامة التجارية

اكتشف ما تضيفه SKU.md إلى منصتك وكيف تبدأ تجربة بمنتج واحد.

تكامل SKU.md مع BigCommerce

تمت مراجعة المصادر الرسمية على 2026-08-07

تأتي بيانات القدرة BigCommerce من docs.bigcommerce.com. تتم تسمية متطلبات التسليم SKU-MD بشكل منفصل كقواعد تحقق مستقلة.

البداية السريعة للمطور ↗
نظرة عامة على النظام الأساسي ووضع الحماية وبيانات الاعتماد ونقاط الدخول REST وGraphQL.
حسابات API ↗
أنواع الحسابات، والوصول إلى tokens، ونطاقات OAuth، وحدود المصادقة.
GraphQL مصادقة واجهة المتجر ↗
متطلبات واجهة المتجر والخاصة والعملاء token.
منتجات GraphQL ↗
حقول المنتج والمتغير والسعر وحقل التعريف والكتالوج مرئية.
Webhooks ↗
آليات تسليم الأحداث وعمليات الاسترجاعات وإعادة المحاولة والحدود والأمان.
Scripts API ↗
تثبيت البرنامج النصي المتوافق مع القناة وقيود واجهة المتجر.
قوالب Stencil المخصصة ↗
أنواع الصفحات المدعومة والواجبات وحدود تعيين عناوين URL.
مسارات headless ↗
البحث عن مسار GraphQL للمنتجات والفئات والصفحات والمدونات وعمليات إعادة التوجيه.
محتوى موقع headless ↗
الصفحات والمناطق المعروضة والمدونات واللافتات واسترجاع المحتوى المستند إلى المسار.

الأسئلة الشائعة حول التكامل مع BigCommerce

هل يتصل المولد بحساب BigCommerce؟

لا، فهو يقرأ HTML العام وصفحة منتج same-origin واحدة صريحة. لا يحتوي على تسجيل دخول أو token أو تدفق OAuth أو اتصال BigCommerce API.

لماذا لا تتصل بـ GraphQL Storefront API مباشرة؟

يتطلب BigCommerce bearer token مناسبًا. لا يقبل المولد العام أي بيانات اعتماد عمدًا، ولا يمرّر private tokens عبر وكيل.

هل يمكن لـ Stencil نشر /sku.md مباشرة؟

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

هل يمكن لـ Scripts API نشر الملف؟

يقوم Scripts API بتثبيت البرامج النصية لواجهة المتجر من جانب العميل. يمكن أن يعلن البرنامج النصي عن رابط اكتشاف، ولكنه ليس استجابة مستند HTTP 200 text/markdown المطلوبة.

ما الذي يمكن أن تفعله واجهات متاجر headless؟

يمكن لتطبيق headless الذي يتحكم فيه التاجر تنفيذ المسار، ولكن التسليم الصارم لا يوجد إلا بعد أن تمر استجابة same-origin الحقيقية بالحالة وMIME والبايت والرسم البياني وذاكرة التخزين المؤقت و404 عمليات فحص.

ما الذي ينشئه المولد أولاً؟

ينشئ دائمًا الحد الأدنى من جذر v1 أولاً. مستند معرفة المنتج المرتبط بـ Source اختياري.

هل يحل مستند معرفة المنتج محل الكتالوج المباشر؟

لا. يحتوي فقط على حقائق صريحة مرتبطة بـ Source، ولا يحمل سعرًا أو مخزونًا مباشرًا. وتبقى سلة التسوق وإتمام الشراء والمدفوعات والطلبات في BigCommerce.

هل يدعم BigCommerce رسميًا SKU-MD؟

لا يوجد مصدر رسمي تمت مراجعته يقول ذلك. يقوم هذا الدليل المستقل بتعيين إمكانات BigCommerce الموثقة لسير العمل الذي يتحكم فيه التاجر؛ ولا يوثق الاعتماد الرسمي لـ BigCommerce لـ SKU-MD.

ابدأ بالأدلة العامة، ثم انشر فقط ما يمكنك التحقق منه

أنشئ مسودة قابلة للمراجعة من دون بيانات اعتماد. استخدم Stencil للاكتشاف، أو مسار headless أو edge يتحكم فيه التاجر لتقديم Markdown يمكن التحقق منه.