สคีมาถูกต้องแต่ยังเผยแพร่ไม่ได้: ข้อผิดพลาดการส่ง SKU.md 10 ประการ

สคีมาที่ผ่านตอบเพียงว่าโครงสร้างในเครื่องถูกต้อง ทรัพยากรสาธารณะยังอาจมี URL สถานะ MIME ไบต์ URL หลัก หรือกราฟที่ผิด

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

ข้อผิดพลาดการส่งสิบประการ

ลำดับ	ความล้มเหลว	การตรวจแบบแน่นอน
1	สถานะผิด	ต้องเป็น HTTP 200 พอดี
2	มีการเปลี่ยนเส้นทาง	ปิดการตามและตรวจ URL ที่ร้องขอ
3	MIME ผิด	ต้องเป็น text/markdown พร้อมพารามิเตอร์ที่ยอมรับ
4	ตอบหน้าอื่นแทน	ปฏิเสธ HTML หรือไบต์หน้าแรก
5	URL หลักผิดหรือหาย	เทียบข้อมูลส่วนหัวกับ URL ที่ร้องขอ
6	เนื้อหาไม่ตรง	เทียบไบต์กับฟิลด์ที่ยอมรับ
7	ลิงก์เสีย	เรียกทรัพยากรบังคับอย่างปลอดภัย
8	กราฟหรือลิงก์เอกสารแม่ขาด	เดินจาก /sku.md ตาม parent
9	เวอร์ชันผิด	ต้องเป็น sku.md/0.10-draft และสคีมาที่ตั้งใจ
10	ข้ามการตรวจออนไลน์	เรียก published_resource และ document_graph

ลำดับแก้ปัญหา

1. เรียก HTTPS URL ที่แน่นอนโดยไม่ตามการเปลี่ยนเส้นทาง
2. ตรวจ HTTP, MIME และไบต์
3. เทียบ URL หลัก เวอร์ชัน ตัวตน และเนื้อหา
4. เดินลิงก์บังคับกับสายเอกสารแม่
5. ยืนยันว่าเส้นทางที่ไม่รู้จักตอบ 404 พอดี
6. ล้าง CDN แล้วตรวจซ้ำพร้อมเก็บหลักฐาน

เหตุใดสัญญาณในเครื่องจึงพลาด

หน้าที่อ่านได้อาจเป็น HTML เพื่อความเข้ากันได้ การนำขึ้นใช้งานสำเร็จอาจยังส่งแคชเก่า และ URL สินค้าหนึ่งรายการไม่พิสูจน์มานิเฟสต์ที่รากหรือเอกสารข้างเคียง แม้ HTTP 200 ก็ไม่มีความหมายหากเป็นหน้าแรกที่ MIME ผิด จึงต้องทดสอบทั้งกรณีสำเร็จและกรณีปฏิเสธตามสัญญาทรัพยากร

ซ่อมโดยไม่เสียฉบับล่าสุด

เก็บเอกสารล่าสุดที่ยอมรับไว้ก่อน แก้เส้นทางหรือส่วนหัว HTTP ในสภาพแวดล้อมแยก แล้วค่อยแทนทรัพยากร อย่าซ่อนข้อผิดพลาดด้วยการเปลี่ยนเส้นทางหรือเปลี่ยน URL หลักเพื่อให้ข้อสอบผ่าน หลังซ่อมต้องตรวจ offline_document, published_resource และ document_graph ใหม่ทั้งหมด โดยเทียบกับ ข้อกำหนด v0.10

อ่านเพิ่มเติม

ใช้ คู่มือเผยแพร่ที่แม่นยำ และ การแยกข้อมูลปัจจุบัน

ขั้นตอนถัดไป

เรียกชุดทดสอบความสอดคล้อง