ข้ามไปยังเนื้อหา
SKU.md
เมนู
ไทย

BIGCOMMERCE · SKU-MD v1.0.0-beta

เผยแพร่เอกสารรากขั้นต่ำก่อน แล้วเพิ่มเฉพาะความรู้ที่มีแหล่งที่มา

ป้อนหน้าร้านหรือแคตตาล็อกสาธารณะ หรือหน้าสินค้าสาธารณะหนึ่งหน้า สร้างเอกสารรากขั้นต่ำก่อน แล้วเลือกเพิ่มเอกสารความรู้สินค้าที่เชื่อมโยง 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

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

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

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

ต้องมี HTTP 200 และ Content-Type: text/markdown ที่ถูกต้อง พร้อมข้อมูลระบุตัวตนของไบต์ กราฟเอกสารที่ถูกต้อง การแทนที่แคชที่คาดเดาได้ และ 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 กับ 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 ที่ร้องขอ

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

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

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

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

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

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

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

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

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

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

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