ข้ามไปยังเนื้อหา

เผยแพร่ SKU.md บนร้าน BigCommerce

ป้อนหน้าร้านหรือแคตตาล็อกสาธารณะ หรือหน้าสินค้าสาธารณะหนึ่งหน้า สร้างเอกสารรากขั้นต่ำก่อน แล้วเลือกเพิ่มเอกสารความรู้สินค้าที่เชื่อมโยง Source ได้

เปิดตัวสร้าง BigCommerce

ไม่ใช้ข้อมูลรับรอง · ไม่ใช้ API ส่วนตัว · ไม่รวบรวมข้อมูลจำนวนมาก · ไม่เผยแพร่อัตโนมัติ

BigCommerce ดำเนินการซื้อขายสด SKU.md นำความรู้ที่ได้รับการตรวจสอบแล้ว

การบูรณาการช่วยให้ธุรกรรมแบบไดนามิกและความรู้เกี่ยวกับผลิตภัณฑ์คงทนอยู่ในระบบที่สามารถรองรับธุรกรรมเหล่านั้นได้จริง

BIGCOMMERCE

แหล่งข้อมูลหลักของการซื้อขายปัจจุบัน

เป็นเจ้าของผลิตภัณฑ์ปัจจุบัน ตัวเลือกสินค้า ราคาช่องทาง สินค้าคงคลัง นักช้อป ตะกร้าสินค้า คำสั่งซื้อ และพฤติกรรมการชำระเงิน

SKU.md

สัญญาเอกสารสาธารณะขั้นต่ำ

เผยแพร่ราก v1 ที่ /sku.md และเพิ่มเอกสารความรู้สินค้าที่เชื่อมโยง Source แบบเลือกได้หนึ่งรายการเมื่อจำเป็น

ตัวสร้างปัจจุบันใช้เฉพาะหลักฐานสาธารณะ

ขั้นตอนนี้ใช้เฉพาะข้อมูลสาธารณะและไฟล์ที่สร้างในเครื่อง

  1. 01

    ป้อน URL สาธารณะ

    ระบุหน้าร้านหรือแคตตาล็อกสาธารณะ หรือหน้าสินค้าสาธารณะหนึ่งหน้า

  2. 02

    สร้างเอกสารรากขั้นต่ำ

    สร้างและตรวจสอบราก v1 ก่อนเพิ่มเอกสารเสริม

  3. 03

    เพิ่มเฉพาะความรู้ที่มีแหล่งที่มา

    เลือกสร้างเอกสารความรู้สินค้าแบบเชื่อมโยง Source หนึ่งรายการจากหน้าสินค้าที่ระบุอย่างชัดเจน

  4. 04

    เผยแพร่และตรวจสอบ

    เผยแพร่ /sku.md แล้วตรวจสอบขอบเขต document, published และ graph

ความสามารถของ BigCommerce แก้ปัญหาส่วนต่างๆ ของวงจรการใช้งาน

ส่วนเชื่อมต่อเหล่านี้มีอยู่ในเอกสาร BigCommerce การระบุไว้ไม่ได้หมายความว่าตัวสร้างสาธารณะปัจจุบันเรียกใช้ส่วนเชื่อมต่อเหล่านี้

สาธารณะ

หน้าร้าน แคตตาล็อก หรือหน้าสินค้า

ตัวสร้างอ่านเฉพาะ URL สาธารณะที่ผู้ใช้ป้อน ไม่อนุมานสินค้าอื่นและไม่รวบรวมข้อมูลแคตตาล็อก

หน้าร้าน

GraphQL Storefront API

ค้นหาสินค้าที่มองเห็น ตัวเลือกสินค้า ราคา storefront metafields เส้นทาง และเนื้อหา คำขอต้องใช้ bearer token ที่เหมาะสม แต่ตัวสร้างปัจจุบันไม่รับ token ใด ๆ

การจัดการ

REST Management API

บัญชี API ที่ได้รับอนุญาตสามารถจัดการแคตตาล็อกและจัดเก็บข้อมูลโดยใช้ข้อมูลรับรองที่กำหนดขอบเขตได้ นี่คืออินพุตการซิงโครไนซ์ฝั่งเซิร์ฟเวอร์ในอนาคต ไม่ใช่แหล่งที่มาของเบราว์เซอร์สาธารณะ

การรับรองความถูกต้อง

บัญชี API และ OAuth

บัญชีระดับร้านค้าและระดับแอปมีขอบเขตการเข้าถึง token และ OAuth ข้อมูลลับยังคงอยู่ฝั่งเซิร์ฟเวอร์และจำเป็นต้องมีสิทธิพิเศษน้อยที่สุด

กิจกรรม

Webhooks

การนำส่ง HTTPS, Pub/Sub หรือ EventBridge สามารถทริกเกอร์การรีเฟรชส่วนเพิ่มได้ ผู้รับยังคงต้องการการรับรองความถูกต้อง idempotency ลองจัดการอีกครั้ง และการกระทบยอด

UI หน้าร้าน

Scripts API

แอพที่ได้รับอนุญาตสามารถเพิ่มสคริปต์หน้าร้านที่รับรู้ช่องได้ สคริปต์สามารถประกาศลิงก์การค้นพบได้ แต่โค้ดฝั่งไคลเอ็นต์ไม่ใช่การตอบสนอง Markdown ที่ร้องขอ

จัดส่ง

หน้าร้าน Stencil และ headless

เทมเพลตที่กำหนดเองของ Stencil ได้รับการกำหนดให้กับประเภทเพจที่มีอยู่ headless หรือเลเยอร์ Edge ที่ผู้ค้าควบคุมสามารถใช้เส้นทางเอกสาร same-origin ที่แน่นอนได้

แหล่งข้อมูลอย่างเป็นทางการที่ได้รับการตรวจสอบแล้วไม่ได้บันทึกการใช้ BigCommerce ของ SKU.md ความสามารถของแพลตฟอร์ม การค้นพบที่เข้ากันได้ ความสอดคล้องที่เข้มงวด และอำนาจที่มีอยู่ยังคงเป็นข้อเรียกร้องที่แยกจากกัน

เลือกการจัดส่งตามคำตอบที่คุณสามารถพิสูจน์ได้

Markdown ที่สร้างขึ้นจะเหมือนกันในทุกโหมด เฉพาะเส้นทางที่ใช้งานเท่านั้นที่จะกำหนดว่าสิ่งพิมพ์เข้ากันได้หรือเข้มงวด

การค้นพบ

หน้าร้าน Stencil

เพิ่มลิงก์ที่มองเห็นได้หรือที่เครื่องค้นพบได้ผ่านธีม หน้าเนื้อหาที่มีอยู่ หรือสคริปต์ที่จัดการโดยแอป

เทมเพลต Stencil แสดงผลประเภทหน้าหน้าร้านที่มีอยู่ Scripts API ติดตั้งสคริปต์ ไม่มีเพียงอย่างเดียวที่พิสูจน์การตอบสนองของพาธราก text/markdown / text/plain (UTF-8)

ผู้สมัครที่เข้มงวด

เส้นทาง headless ที่ผู้ขายควบคุม

ให้บริการไฟล์ที่ผ่านการตรวจสอบล่วงหน้าแล้วไม่เปลี่ยนรูปจากแอปพลิเคชันหน้าร้านโดยคงลิงก์ย้อนกลับ Catalog และ Product URL ไว้ที่ต้นทางเดียวกัน

ต้องมี HTTP 200 และ Content-Type: text/markdown / text/plain (UTF-8) ที่ถูกต้อง พร้อมข้อมูลระบุตัวตนของไบต์ กราฟเอกสารที่ถูกต้อง การแทนที่แคชที่คาดเดาได้ และ 404 ที่แน่นอนสำหรับไฟล์ที่ไม่รู้จัก

ผู้สมัครที่เข้มงวด

เส้นทางขอบต้นทางเดียวกัน

ให้บริการเอกสารที่เก็บไว้ที่ /sku.md และเส้นทางเอกสารผลิตภัณฑ์ก่อนที่คำขอจะไปถึงหน้าร้านที่โฮสต์

กฎการกำหนดเส้นทางไม่ใช่ข้อพิสูจน์ ตรวจสอบการตอบสนองที่แท้จริงหลังจากการเปลี่ยนแปลงสิ่งพิมพ์ทุกครั้ง

โหมดมันทำอะไรได้บ้างขอบเขตหลักฐาน
Stencilใช้ธีม เพจแบบกำหนดเอง หรือการผสานรวม Scripts API เพื่อแสดงคำแนะนำในการค้นพบการค้นพบที่เข้ากันได้เท่านั้น พื้นผิวที่จัดทำเอกสารไม่ได้สร้างการตอบสนอง Markdown ของรูทพาธโดยพลการ
headlessให้บริการไฟล์ที่ยอมรับจากแอปพลิเคชันหน้าร้านที่ผู้ขายควบคุมในต้นทางของร้านค้าเข้มงวดเฉพาะหลังจากเส้นทาง ประเภทสื่อ ไบต์ กราฟ การแทนที่แคช และการส่งผ่านลักษณะการทำงาน 404 เท่านั้น
ขอบสกัดกั้นเส้นทางเอกสาร same-origin ก่อนหน้าร้านที่โฮสต์และส่งคืนไบต์ที่ยอมรับที่เก็บไว้เข้มงวดเฉพาะหลังจากที่การตอบกลับสาธารณะได้รับการตรวจสอบอย่างเป็นอิสระจากการกำหนดค่าแล้วเท่านั้น

รักษากลุ่มเอกสาร v1 ให้มีขอบเขตขั้นต่ำ

ตัวสร้างเฉพาะใช้ตัวสร้างและตัวตรวจสอบ v1 เดียวกับขั้นตอนทั่วไป

เริ่มจากรากขั้นต่ำ

สร้างราก v1 ด้วยข้อมูลระบุร้านสาธารณะและจุดเข้าแคตตาล็อก

เอกสารสินค้าเสริมหนึ่งรายการ

เพิ่มความรู้สินค้าเฉพาะหน้าสินค้าสาธารณะหนึ่งหน้าที่ผู้ใช้ระบุอย่างชัดเจน

ข้อเท็จจริงที่เชื่อมโยง Source

ทุกข้อเท็จจริงเชื่อมโยง Source สาธารณะ และตัวตรวจสอบ graph ตรวจสอบความสัมพันธ์ของเอกสาร

ขอบเขตแบบระมัดระวัง

หากไม่มีความรู้สินค้าที่มีแหล่งที่มา ให้คงรากที่ถูกต้องไว้และไม่สร้างเอกสารเสริม

ตรวจสอบทุกขอบเขตการเผยแพร่

การสร้างและการเผยแพร่เป็นคนละขั้นตอน จึงต้องมีหลักฐานแยกสำหรับแต่ละขอบเขต

  1. document

    ตรวจสอบไบต์ที่สร้าง

    เรียกตัวตรวจสอบเอกสาร v1 ปัจจุบันก่อนเผยแพร่

  2. published

    ตรวจสอบการตอบกลับสาธารณะ

    ตรวจสอบสถานะ MIME และไบต์ของ /sku.md จริง

  3. graph

    ตรวจสอบความสัมพันธ์

    ตรวจสอบเอกสารที่อ้างอิงและความสัมพันธ์ Source ทั้งหมด

  4. ทำซ้ำ

    ตรวจสอบอีกครั้งหลังเปลี่ยนแปลง

    เรียกทุกขอบเขตใหม่เมื่อไฟล์ที่เผยแพร่เปลี่ยน

ขั้นตอนปัจจุบันไม่เชื่อมต่อบัญชี BigCommerce และไม่เผยแพร่ไฟล์โดยอัตโนมัติ

สิทธิ์และขีดจำกัดรุ่นปัจจุบัน

ขั้นตอนการทำงานสาธารณะยังคงแคบ ตรวจสอบได้ และควบคุมโดยผู้ค้า

  • ไม่มีการเข้าสู่ระบบ BigCommerce, บัญชี API, ขั้นตอน OAuth, เข้าถึง token, หน้าร้าน token หรือ token ส่วนตัว
  • ไม่มีคำขอ REST Management API หรือ GraphQL Storefront API และไม่มีการรวบรวมข้อมูลแคตตาล็อก
  • ไม่มีการเข้าถึงคำสั่งซื้อ ลูกค้า ตะกร้าสินค้า ขั้นตอนชำระเงิน การชำระเงิน หรือสินค้าส่วนตัว
  • ไม่มีการสมัครสมาชิก Webhook การซิงโครไนซ์พื้นหลัง การแก้ไขธีม การติดตั้งสคริปต์ หรือการรีเฟรชอัตโนมัติ
  • ไม่มีการเปลี่ยนแปลง DNS, พร็อกซี, Edge, แคช หรือสิ่งพิมพ์ที่ใช้งานจริง
  • ไม่มีการเรียกร้องการรับรอง BigCommerce การเป็นหุ้นส่วน การสนับสนุน SKU.md อย่างเป็นทางการ หรือผลประโยชน์ในการนำไปใช้

มุมมองของแบรนด์

ดูว่า SKU.md ช่วยเสริมแพลตฟอร์มอย่างไร และจะเริ่มทดลองกับสินค้าหนึ่งรายการได้อย่างไร

การนำ SKU.md v1 ไปใช้บนแพลตฟอร์ม

บทความ beta ในอดีต: การเชื่อมต่อ SKU.md กับ BigCommerce

ตรวจสอบแหล่งข้อมูลอย่างเป็นทางการใน 2026-08-07

คำชี้แจงความสามารถ BigCommerce มาจาก docs.bigcommerce.com ข้อกำหนดการจัดส่ง SKU.md มีป้ายกำกับแยกต่างหากว่าเป็นกฎการตรวจสอบอิสระ

คำถามที่พบบ่อยเกี่ยวกับการรวม BigCommerce

ตัวสร้างเชื่อมต่อกับบัญชี BigCommerce หรือไม่

ไม่ โดยจะอ่าน HTML สาธารณะและหน้าผลิตภัณฑ์ same-origin ที่ชัดเจนหนึ่งหน้า ไม่มีการเข้าสู่ระบบ, token, โฟลว์ OAuth หรือการเชื่อมต่อ BigCommerce API

ทำไมไม่โทรหา GraphQL Storefront API โดยตรง

BigCommerce ต้องมีผู้ถือที่เหมาะสม token โปรแกรมสร้างสาธารณะจงใจไม่ยอมรับข้อมูลรับรอง และไม่พร็อกซี token ส่วนตัว

Stencil สามารถเผยแพร่ /sku.md โดยตรงได้หรือไม่

เอกสารประกอบเทมเพลตแบบกำหนดเองที่ได้รับการตรวจสอบแล้วครอบคลุมถึงแบรนด์ หมวดหมู่ ผลิตภัณฑ์ และประเภทเพจที่มีอยู่ มันไม่ได้สร้างการตอบสนอง Markdown ของรูทพาธโดยพลการ

Scripts API สามารถเผยแพร่ไฟล์ได้หรือไม่

Scripts API ติดตั้งสคริปต์หน้าร้านฝั่งไคลเอ็นต์ สคริปต์สามารถประกาศลิงก์การค้นพบได้ แต่ไม่ใช่การตอบกลับเอกสาร HTTP 200 text/markdown / text/plain (UTF-8) ที่ร้องขอ

หน้าร้าน headless ทำอะไรได้บ้าง?

แอปพลิเคชัน headless ที่ผู้ค้าควบคุมสามารถใช้เส้นทางได้ แต่การจัดส่งที่เข้มงวดจะเกิดขึ้นหลังจากที่การตอบกลับ same-origin จริงผ่านสถานะ, MIME, ไบต์, กราฟ, แคช และการตรวจสอบ 404 เท่านั้น

ตัวสร้างสร้างอะไรก่อน

ตัวสร้างสร้างราก v1 ขั้นต่ำก่อนเสมอ ส่วนเอกสารความรู้สินค้าที่เชื่อมโยง Source เป็นตัวเลือก

เอกสารความรู้สินค้าแทนที่แคตตาล็อกสดหรือไม่

ไม่ เอกสารมีเฉพาะข้อเท็จจริงที่เชื่อมโยง Source และไม่มีราคาหรือสถานะสินค้าคงคลังสด ตะกร้าสินค้า เช็กเอาต์ การชำระเงิน และคำสั่งซื้อยังอยู่ใน BigCommerce

BigCommerce รองรับ SKU.md อย่างเป็นทางการหรือไม่

ไม่มีแหล่งข้อมูลอย่างเป็นทางการที่ได้รับการตรวจสอบกล่าวเช่นนั้น คู่มืออิสระนี้แมปบันทึกความสามารถของ BigCommerce กับเวิร์กโฟลว์ที่ผู้ค้าควบคุม ไม่ได้บันทึกการนำ BigCommerce มาใช้อย่างเป็นทางการของ SKU.md

เริ่มต้นด้วยหลักฐานสาธารณะ จากนั้นเผยแพร่เฉพาะสิ่งที่คุณสามารถตรวจสอบได้

สร้างฉบับร่างที่ตรวจสอบได้โดยไม่มีข้อมูลรับรอง ใช้ Stencil สำหรับการค้นหาหรือ headless ที่ผู้ขายควบคุมหรือเส้นทาง Edge สำหรับการจัดส่ง Markdown ที่ตรวจสอบได้

เปิดตัวสร้าง BigCommerce