{"pageKey":"Developers","slug":"developers-api-integrations","locale":"th","localeResolved":"th","fallbackApplied":false,"version":"developers-api-integrations@2026-07-21T09:39:17.914Z","lastModified":"2026-07-21T09:39:17.914Z","canonicalUrl":"https://www.merchandaise.com/th/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"สินค้าพรีเมียม API & ข้อกำหนดการเชื่อมต่อระบบ | MerchandAise","description":"สำรวจข้อกำหนด MerchandAise สำหรับเครื่องมือผู้ช่วย, การฝังระบบในคอมมูนิตี้, การดำเนินงานของซัพพลายเออร์ และระบบยืนยันตัวตนระดับองค์กร พร้อมขอบเขตการเข้าถึงแบบสาธารณะและแบบได้รับการปกป้องที่ชัดเจน","sections":[{"heading":"รักษาแหล่งข้อมูลหลักเพียงชุดเดียว","paragraphs":["การรวมระบบควรขยายเวิร์กโฟลว์ของ MerchandAise ไม่ใช่แยกแหล่งข้อมูล ผู้ใช้งานจากเว็บไซต์ ฝังชุมชน ฝั่งซัพพลายเออร์ องค์กร หรือผู้ช่วย ต้องอ่านและอัพเดตการออกแบบ ความตั้งใจทางการค้า ใบเสนอราคา การอนุมัติ และสถานะคำสั่งซื้อที่มีเวอร์ชันเดียวกัน","เมื่อ MerchandAise ดำเนินการธุรกรรมฝั่งผู้ซื้อ Hutter Products GmbH เป็นผู้ขายตามสัญญาและ Merchant of Record ภายใต้แบรนด์ MerchandAise ข้อมูลประจำตัวและข้อมูลติดต่อของซัพพลายเออร์จะยังคงเป็นข้อมูลส่วนตัว เว้นแต่จำเป็นต้องเปิดเผย และการผลิตยังคงต้องได้รับการอนุมัติทั้ง digital-proof และตัวอย่างผลิตภัณฑ์จริงก่อนการผลิตจำนวนมาก"]},{"heading":"อินเทอร์เฟซ API และการเชื่อมต่อ","items":[{"title":"เอกสาร API เครื่องมือผู้ช่วย","description":"ดูจุดเชื่อมต่อปัจจุบันสำหรับการสессชันออกแบบและการตรวจสอบการรวมระบบ เอกสารอ้างอิงสาธารณะนี้ไม่ได้มอบสิทธิ์ให้บุคคลไม่ระบุตัวตนสามารถให้ราคา หรือสั่งซื้อได้ Human guide: ดูเอกสารเครื่องมือผู้ช่วย (/th/developers/api-integrations). Machine-readable contract: OpenAPI JSON ของเครื่องมือผู้ช่วย (/api/docs/openapi.json). Access: public. เอกสารอ้างอิงสาธารณะสำหรับ API ของเครื่องมือผู้ช่วย การเข้าถึงเพื่อการผลิตและการดำเนินการที่มีผลกระทบต่อคำสั่งซื้อยังคงต้องมีการอนุญาตที่เหมาะสม Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs."},{"title":"API ฝังสำหรับชุมชน","description":"เชื่อมประสบการณ์คลับ ชุมชน หรือตู้โชว์ท้องถิ่นกับการส่งมอบการออกแบบและการค้าของ MerchandAise โดยไม่ต้องสร้างเวิร์กโฟลว์พื้นฐานขึ้นมาใหม่ Human guide: ทบทวนคู่มือการรวมชุมชน (/th/developers/api-integrations#community-integrations). Machine-readable contract: OpenAPI JSON สำหรับชุมชน (/api/v1/community/public/openapi/v1). Access: public. สัญญาเวอร์ชันสาธารณะสำหรับการฝัง storefront การค้นหาในชุมชน และการส่งต่อที่คำนึงถึงภูมิภาค Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations."},{"title":"API ซัพพลายเออร์","description":"เชื่อมซัพพลายเออร์ที่ได้รับอนุมัติเข้ากับการนำเข้า แคตตาล็อก การเสนอราคา และการปฏิบัติงานหลังการขาย เมื่อแบบการเป็นพันธมิตรและโมเดลการเข้าถึงได้รับการรับรองแล้ว Human guide: ทบทวนคู่มือการรวมซัพพลายเออร์ (/th/developers/api-integrations#supplier-integrations). Machine-readable contract: OpenAPI JSON ของซัพพลายเออร์ (/api/v1/supplier/openapi/v1). Access: public. สัญญาสาธารณะเพื่อการวางแผนและการสร้างไคลเอนต์ การเข้าถึงเชิงปฏิบัติการสำหรับซัพพลายเออร์ยังคงต้องได้รับสิทธิ์ Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations."},{"title":"API ตัวตนสำหรับองค์กร","description":"วางแผน SSO การจัดหาผ่าน SCIM และกระแสตัวตนที่ตรวจสอบได้สำหรับโปรแกรมสินค้าของบริษัทและการเปิดตัวที่มีการกำกับดูแล Human guide: ทบทวนคู่มือการรวมองค์กร (/th/developers/api-integrations#enterprise-integrations). Machine-readable contract: OpenAPI JSON ของตัวตนองค์กร (/api/v1/enterprise/identity/openapi/v1). Access: protected. สัญญาที่ได้รับการป้องกันสำหรับพื้นที่ทำงานองค์กรที่ได้รับอนุมัติ; กรุณาขอการเข้าถึงก่อนใช้งาน endpoint นี้ Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations."}]},{"heading":"เลือกสัญญาก่อนเขียนโค้ด","items":[{"title":"Step 1: ทำแผนผังเส้นทางผู้ใช้","description":"ตัดสินใจว่าใครจะเข้ามาในเวิร์กโฟลว์และจากที่ไหน: ผู้ซื้อใน storefront ฝัง, ซัพพลายเออร์ที่อนุมัติ, ผู้ใช้ในองค์กร หรือผู้ช่วยที่ปฏิบัติการโดยมีการอนุญาตชัดเจน"},{"title":"Step 2: ยืนยันขอบเขตการเข้าถึง","description":"ใช้สัญญาสาธารณะเพื่อประเมินและสร้างไคลเอนต์ จากนั้นยืนยันข้อมูลรับรอง ขอบเขตสิทธิ์ สภาพแวดล้อม คอลแบ็ก และ endpoint ที่ถูกป้องกันก่อนเริ่มใช้งาน"},{"title":"Step 3: พิสูจน์ความต่อเนื่องของสถานะ","description":"ทดสอบให้แน่ใจว่าการออกแบบ ใบเสนอราคา การอนุมัติ ข้อผิดพลาด และการส่งต่อคำสั่งซื้อคงเป็นเวอร์ชันปัจจุบันข้ามการรวมระบบ รวมถึงเส้นทางการลองใหม่และการย้อนกลับ"}]},{"heading":"สิ่งที่การรวมระบบทุกแบบต้องรักษาไว้","items":[{"title":"สถานะเวอร์ชันเดียว","description":"การออกแบบ ความตั้งใจทางการค้า ใบเสนอราคาที่สนับสนุนโดยซัพพลายเออร์ การอนุมัติ และสถานะคำสั่งซื้อต้องเชื่อมต่อกัน การเปลี่ยนแปลงที่ล้าสมัยต้องกระตุ้นการขอราคาใหม่หรือสถานะตรวจสอบที่มองเห็นได้"},{"title":"ความเป็นส่วนตัวเชิงพาณิชย์และซัพพลายเออร์","description":"MerchandAise ยังคงเป็นผู้ค้าติดต่อกับผู้ซื้อและรับผิดชอบงานสนับสนุน ข้อมูลประจำตัว ที่อยู่ติดต่อ และข้อมูลภายในของซัพพลายเออร์จะไม่ถูกเปิดเผยผ่านการรวมเชิงสาธารณะ"},{"title":"การอนุมัติก่อนการผลิต","description":"มุมมอง 3D เฉพาะผลิตภัณฑ์และ digital proof ช่วยรองรับการตัดสินใจ แต่ไม่ทดแทนตัวอย่างผลิตภัณฑ์จริงที่ต้องได้รับการอนุมัติก่อนการผลิตจำนวนมาก"}]},{"heading":"ก่อนการไหลของการผลิตจริง","paragraphs":["ไฟล์ OpenAPI ที่เผยแพร่เป็นพื้นผิวสำหรับการวางแผน ไม่ใช่การให้สิทธิ์เข้าถึงการผลิตโดยบุคคลไม่ระบุตัวตน เราตรวจสอบสภาพแวดล้อม ข้อมูลรับรอง การจัดการข้อผิดพลาด และความรับผิดชอบเชิงปฏิบัติการก่อนเปิดใช้งานจริง"],"items":[{"title":"การเข้าถึงและสภาพแวดล้อม","description":"ยืนยันเวอร์ชันสัญญา พื้นที่ทำงานที่อนุมัติ ขอบเขตการพิสูจน์ตัวตน sandbox ข้อมูลรับรองการผลิต และจุดหมายปลายทางคอลแบ็ก"},{"title":"ความล้มเหลวและการกู้คืน","description":"กำหนดการลองใหม่ ความไม่เปลี่ยนสถานะ (idempotency) เวลาจำกัด ข้อผิดพลาดที่มองเห็นได้สำหรับลูกค้า การสังเกตการณ์ ความรับผิดชอบฝ่ายสนับสนุน และการย้อนกลับก่อนปล่อยใช้งาน"},{"title":"หลักฐานจากต้นจนจบ","description":"ตรวจสอบเส้นทางที่ตั้งใจไว้ในสเตจจากการเข้าร่วม การเปลี่ยนสถานะ ผ่านใบเสนอราคา การอนุมัติ การส่งต่อ และพฤติกรรมการกู้คืน"}]},{"heading":"คำถามที่พบบ่อย","items":[{"title":"ฉันควรเริ่มต้นเชื่อมต่อระบบจากส่วนใด?","description":"เริ่มต้นด้วยบุคคลและการเปลี่ยนสถานะ (person and state transition) โดยใช้การฝังองค์ประกอบชุมชน (community embeds) สำหรับเส้นทางการใช้งานของคลับหรือชุมชนที่ติดต่อกับผู้ซื้อ, ใช้การดำเนินงานของซัพพลายเออร์ (supplier operations) สำหรับเวิร์กโฟลว์ฝั่งซัพพลายที่ได้รับการอนุมัติแล้ว, ใช้ข้อมูลระบุตัวตนระดับองค์กร (enterprise identity) สำหรับ SSO และ SCIM, และใช้เครื่องมือผู้ช่วย (assistant tooling) เฉพาะสำหรับเวิร์กโฟลว์ที่นำโดย AI ซึ่งได้รับอนุญาตอย่างชัดเจนเท่านั้น"},{"title":"สัญญาแบบสาธารณะ (public contract) หมายถึงการเข้าถึงระบบใช้งานจริง (production access) แบบสาธารณะด้วยหรือไม่?","description":"ไม่ใช่ สัญญา OpenAPI แบบสาธารณะมีไว้เพื่อสนับสนุนการค้นหาข้อมูล การตรวจสอบสถาปัตยกรรม และการสร้างไคลเอนต์เท่านั้น ส่วนข้อมูลการเข้าสู่ระบบใช้งานจริง (production credentials) การดำเนินการเขียนข้อมูล เวิร์กโฟลว์ของซัพพลายเออร์ ข้อมูลระบุตัวตนระดับองค์กร และการทำงานของระบบผู้ช่วย ยังคงต้องใช้พื้นที่ทำงานที่ได้รับการอนุมัติและการกำหนดสิทธิ์การเข้าถึงตามขอบเขตที่กำหนด"},{"title":"การเชื่อมต่อระบบสามารถเปิดเผยข้อมูลซัพพลายเออร์หรือข้ามขั้นตอนการอนุมัติได้หรือไม่?","description":"ไม่ได้ ข้อมูลระบุตัวตนและรายละเอียดการติดต่อของซัพพลายเออร์จะถูกเก็บไว้เป็นส่วนตัว เว้นแต่ในกรณีที่จำเป็นต้องเปิดเผยข้อมูล โดย MerchandAise จะเป็นผู้ดูแลความสัมพันธ์กับผู้ซื้อ และการดำเนินการใดๆ ที่ส่งผลกระทบต่อคำสั่งซื้อจะต้องผ่านขั้นตอนการอนุมัติและการตรวจสอบตัวอย่างจริงที่กำหนดไว้เสมอ"}]},{"heading":"มานำเวิร์กโฟลว์มาให้เรา ไม่ใช่สถาปัตยกรรมที่เสร็จแล้ว","paragraphs":["บอกเราว่าใครจะใช้การรวมระบบ ส่วนใดของสถานะที่ต้องอ่านหรือเปลี่ยน และประสบการณ์จะอยู่ที่ไหน เราจะช่วยแม็พสัญญา โมเดลการเข้าถึง และเส้นทางการเปิดตัวที่ปลอดภัยให้คุณ"],"items":[{"title":"วางแผนการเชื่อมต่อ","description":"/th/contact?intent=api-integration-review"},{"title":"สำรวจตัวแทน AI และ MCP","description":"/th/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}