BIGCOMMERCE
แหล่งข้อมูลหลักของการซื้อขายปัจจุบัน
เป็นเจ้าของผลิตภัณฑ์ปัจจุบัน ตัวเลือกสินค้า ราคาช่องทาง สินค้าคงคลัง นักช้อป ตะกร้าสินค้า คำสั่งซื้อ และพฤติกรรมการชำระเงิน
ป้อนหน้าร้านหรือแคตตาล็อกสาธารณะ หรือหน้าสินค้าสาธารณะหนึ่งหน้า สร้างเอกสารรากขั้นต่ำก่อน แล้วเลือกเพิ่มเอกสารความรู้สินค้าที่เชื่อมโยง Source ได้
เปิดตัวสร้าง BigCommerceไม่ใช้ข้อมูลรับรอง · ไม่ใช้ API ส่วนตัว · ไม่รวบรวมข้อมูลจำนวนมาก · ไม่เผยแพร่อัตโนมัติ
การบูรณาการช่วยให้ธุรกรรมแบบไดนามิกและความรู้เกี่ยวกับผลิตภัณฑ์คงทนอยู่ในระบบที่สามารถรองรับธุรกรรมเหล่านั้นได้จริง
BIGCOMMERCE
เป็นเจ้าของผลิตภัณฑ์ปัจจุบัน ตัวเลือกสินค้า ราคาช่องทาง สินค้าคงคลัง นักช้อป ตะกร้าสินค้า คำสั่งซื้อ และพฤติกรรมการชำระเงิน
SKU.md
เผยแพร่ราก v1 ที่ /sku.md และเพิ่มเอกสารความรู้สินค้าที่เชื่อมโยง Source แบบเลือกได้หนึ่งรายการเมื่อจำเป็น
ขั้นตอนนี้ใช้เฉพาะข้อมูลสาธารณะและไฟล์ที่สร้างในเครื่อง
01
ระบุหน้าร้านหรือแคตตาล็อกสาธารณะ หรือหน้าสินค้าสาธารณะหนึ่งหน้า
02
สร้างและตรวจสอบราก v1 ก่อนเพิ่มเอกสารเสริม
03
เลือกสร้างเอกสารความรู้สินค้าแบบเชื่อมโยง Source หนึ่งรายการจากหน้าสินค้าที่ระบุอย่างชัดเจน
04
เผยแพร่ /sku.md แล้วตรวจสอบขอบเขต document, published และ graph
ส่วนเชื่อมต่อเหล่านี้มีอยู่ในเอกสาร BigCommerce การระบุไว้ไม่ได้หมายความว่าตัวสร้างสาธารณะปัจจุบันเรียกใช้ส่วนเชื่อมต่อเหล่านี้
สาธารณะ
ตัวสร้างอ่านเฉพาะ URL สาธารณะที่ผู้ใช้ป้อน ไม่อนุมานสินค้าอื่นและไม่รวบรวมข้อมูลแคตตาล็อก
หน้าร้าน
ค้นหาสินค้าที่มองเห็น ตัวเลือกสินค้า ราคา storefront metafields เส้นทาง และเนื้อหา คำขอต้องใช้ bearer token ที่เหมาะสม แต่ตัวสร้างปัจจุบันไม่รับ token ใด ๆ
การจัดการ
บัญชี API ที่ได้รับอนุญาตสามารถจัดการแคตตาล็อกและจัดเก็บข้อมูลโดยใช้ข้อมูลรับรองที่กำหนดขอบเขตได้ นี่คืออินพุตการซิงโครไนซ์ฝั่งเซิร์ฟเวอร์ในอนาคต ไม่ใช่แหล่งที่มาของเบราว์เซอร์สาธารณะ
การรับรองความถูกต้อง
บัญชีระดับร้านค้าและระดับแอปมีขอบเขตการเข้าถึง token และ OAuth ข้อมูลลับยังคงอยู่ฝั่งเซิร์ฟเวอร์และจำเป็นต้องมีสิทธิพิเศษน้อยที่สุด
กิจกรรม
การนำส่ง HTTPS, Pub/Sub หรือ EventBridge สามารถทริกเกอร์การรีเฟรชส่วนเพิ่มได้ ผู้รับยังคงต้องการการรับรองความถูกต้อง idempotency ลองจัดการอีกครั้ง และการกระทบยอด
UI หน้าร้าน
แอพที่ได้รับอนุญาตสามารถเพิ่มสคริปต์หน้าร้านที่รับรู้ช่องได้ สคริปต์สามารถประกาศลิงก์การค้นพบได้ แต่โค้ดฝั่งไคลเอ็นต์ไม่ใช่การตอบสนอง Markdown ที่ร้องขอ
จัดส่ง
เทมเพลตที่กำหนดเองของ Stencil ได้รับการกำหนดให้กับประเภทเพจที่มีอยู่ headless หรือเลเยอร์ Edge ที่ผู้ค้าควบคุมสามารถใช้เส้นทางเอกสาร same-origin ที่แน่นอนได้
แหล่งข้อมูลอย่างเป็นทางการที่ได้รับการตรวจสอบแล้วไม่ได้บันทึกการใช้ BigCommerce ของ SKU.md ความสามารถของแพลตฟอร์ม การค้นพบที่เข้ากันได้ ความสอดคล้องที่เข้มงวด และอำนาจที่มีอยู่ยังคงเป็นข้อเรียกร้องที่แยกจากกัน
Markdown ที่สร้างขึ้นจะเหมือนกันในทุกโหมด เฉพาะเส้นทางที่ใช้งานเท่านั้นที่จะกำหนดว่าสิ่งพิมพ์เข้ากันได้หรือเข้มงวด
การค้นพบ
เพิ่มลิงก์ที่มองเห็นได้หรือที่เครื่องค้นพบได้ผ่านธีม หน้าเนื้อหาที่มีอยู่ หรือสคริปต์ที่จัดการโดยแอป
เทมเพลต Stencil แสดงผลประเภทหน้าหน้าร้านที่มีอยู่ Scripts API ติดตั้งสคริปต์ ไม่มีเพียงอย่างเดียวที่พิสูจน์การตอบสนองของพาธราก text/markdown / text/plain (UTF-8)
ผู้สมัครที่เข้มงวด
ให้บริการไฟล์ที่ผ่านการตรวจสอบล่วงหน้าแล้วไม่เปลี่ยนรูปจากแอปพลิเคชันหน้าร้านโดยคงลิงก์ย้อนกลับ 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 ด้วยข้อมูลระบุร้านสาธารณะและจุดเข้าแคตตาล็อก
เพิ่มความรู้สินค้าเฉพาะหน้าสินค้าสาธารณะหนึ่งหน้าที่ผู้ใช้ระบุอย่างชัดเจน
ทุกข้อเท็จจริงเชื่อมโยง Source สาธารณะ และตัวตรวจสอบ graph ตรวจสอบความสัมพันธ์ของเอกสาร
หากไม่มีความรู้สินค้าที่มีแหล่งที่มา ให้คงรากที่ถูกต้องไว้และไม่สร้างเอกสารเสริม
การสร้างและการเผยแพร่เป็นคนละขั้นตอน จึงต้องมีหลักฐานแยกสำหรับแต่ละขอบเขต
document
เรียกตัวตรวจสอบเอกสาร v1 ปัจจุบันก่อนเผยแพร่
published
ตรวจสอบสถานะ MIME และไบต์ของ /sku.md จริง
graph
ตรวจสอบเอกสารที่อ้างอิงและความสัมพันธ์ Source ทั้งหมด
ทำซ้ำ
เรียกทุกขอบเขตใหม่เมื่อไฟล์ที่เผยแพร่เปลี่ยน
ขั้นตอนปัจจุบันไม่เชื่อมต่อบัญชี BigCommerce และไม่เผยแพร่ไฟล์โดยอัตโนมัติ
ขั้นตอนการทำงานสาธารณะยังคงแคบ ตรวจสอบได้ และควบคุมโดยผู้ค้า
ดูว่า SKU.md ช่วยเสริมแพลตฟอร์มอย่างไร และจะเริ่มทดลองกับสินค้าหนึ่งรายการได้อย่างไร
การนำ SKU.md v1 ไปใช้บนแพลตฟอร์มคำชี้แจงความสามารถ BigCommerce มาจาก docs.bigcommerce.com ข้อกำหนดการจัดส่ง SKU.md มีป้ายกำกับแยกต่างหากว่าเป็นกฎการตรวจสอบอิสระ
ภาพรวมแพลตฟอร์ม, แซนด์บ็อกซ์, ข้อมูลรับรอง, จุดเข้าใช้งาน REST และ GraphQL
ประเภทบัญชี เข้าถึง tokens ขอบเขต OAuth และขอบเขตการตรวจสอบสิทธิ์
ข้อกำหนด token สำหรับหน้าร้าน ส่วนตัว และลูกค้า
ฟิลด์ผลิตภัณฑ์ที่มองเห็น ตัวเลือกสินค้า ราคา เมตาฟิลด์ และแค็ตตาล็อก
กลไกการจัดกิจกรรม การโทรกลับ การลองใหม่ ขีดจำกัด และการรักษาความปลอดภัย
การติดตั้งสคริปต์การรับรู้ช่องทางและข้อจำกัดหน้าร้าน
ประเภทเพจที่รองรับ การกำหนด และขอบเขตการแมป URL
GraphQL ค้นหาเส้นทางสำหรับผลิตภัณฑ์ หมวดหมู่ หน้า บล็อก และการเปลี่ยนเส้นทาง
เพจ ภูมิภาคที่แสดงผล บล็อก แบนเนอร์ และการดึงเนื้อหาตามเส้นทาง
ไม่ โดยจะอ่าน HTML สาธารณะและหน้าผลิตภัณฑ์ same-origin ที่ชัดเจนหนึ่งหน้า ไม่มีการเข้าสู่ระบบ, token, โฟลว์ OAuth หรือการเชื่อมต่อ BigCommerce API
BigCommerce ต้องมีผู้ถือที่เหมาะสม token โปรแกรมสร้างสาธารณะจงใจไม่ยอมรับข้อมูลรับรอง และไม่พร็อกซี token ส่วนตัว
เอกสารประกอบเทมเพลตแบบกำหนดเองที่ได้รับการตรวจสอบแล้วครอบคลุมถึงแบรนด์ หมวดหมู่ ผลิตภัณฑ์ และประเภทเพจที่มีอยู่ มันไม่ได้สร้างการตอบสนอง Markdown ของรูทพาธโดยพลการ
Scripts API ติดตั้งสคริปต์หน้าร้านฝั่งไคลเอ็นต์ สคริปต์สามารถประกาศลิงก์การค้นพบได้ แต่ไม่ใช่การตอบกลับเอกสาร HTTP 200 text/markdown / text/plain (UTF-8) ที่ร้องขอ
แอปพลิเคชัน headless ที่ผู้ค้าควบคุมสามารถใช้เส้นทางได้ แต่การจัดส่งที่เข้มงวดจะเกิดขึ้นหลังจากที่การตอบกลับ same-origin จริงผ่านสถานะ, MIME, ไบต์, กราฟ, แคช และการตรวจสอบ 404 เท่านั้น
ตัวสร้างสร้างราก v1 ขั้นต่ำก่อนเสมอ ส่วนเอกสารความรู้สินค้าที่เชื่อมโยง Source เป็นตัวเลือก
ไม่ เอกสารมีเฉพาะข้อเท็จจริงที่เชื่อมโยง Source และไม่มีราคาหรือสถานะสินค้าคงคลังสด ตะกร้าสินค้า เช็กเอาต์ การชำระเงิน และคำสั่งซื้อยังอยู่ใน BigCommerce
ไม่มีแหล่งข้อมูลอย่างเป็นทางการที่ได้รับการตรวจสอบกล่าวเช่นนั้น คู่มืออิสระนี้แมปบันทึกความสามารถของ BigCommerce กับเวิร์กโฟลว์ที่ผู้ค้าควบคุม ไม่ได้บันทึกการนำ BigCommerce มาใช้อย่างเป็นทางการของ SKU.md
สร้างฉบับร่างที่ตรวจสอบได้โดยไม่มีข้อมูลรับรอง ใช้ Stencil สำหรับการค้นหาหรือ headless ที่ผู้ขายควบคุมหรือเส้นทาง Edge สำหรับการจัดส่ง Markdown ที่ตรวจสอบได้
เปิดตัวสร้าง BigCommerce