# สินค้าพรีเมียม API & ข้อกำหนดการเชื่อมต่อระบบ | MerchandAise

- slug: developers-api-integrations
- locale: th
- localeResolved: th
- canonical: https://www.merchandaise.com/th/developers/api-integrations

สำรวจข้อกำหนด MerchandAise สำหรับเครื่องมือผู้ช่วย, การฝังระบบในคอมมูนิตี้, การดำเนินงานของซัพพลายเออร์ และระบบยืนยันตัวตนระดับองค์กร พร้อมขอบเขตการเข้าถึงแบบสาธารณะและแบบได้รับการปกป้องที่ชัดเจน

## รักษาแหล่งข้อมูลหลักเพียงชุดเดียว
การรวมระบบควรขยายเวิร์กโฟลว์ของ MerchandAise ไม่ใช่แยกแหล่งข้อมูล ผู้ใช้งานจากเว็บไซต์ ฝังชุมชน ฝั่งซัพพลายเออร์ องค์กร หรือผู้ช่วย ต้องอ่านและอัพเดตการออกแบบ ความตั้งใจทางการค้า ใบเสนอราคา การอนุมัติ และสถานะคำสั่งซื้อที่มีเวอร์ชันเดียวกัน
เมื่อ MerchandAise ดำเนินการธุรกรรมฝั่งผู้ซื้อ Hutter Products GmbH เป็นผู้ขายตามสัญญาและ Merchant of Record ภายใต้แบรนด์ MerchandAise ข้อมูลประจำตัวและข้อมูลติดต่อของซัพพลายเออร์จะยังคงเป็นข้อมูลส่วนตัว เว้นแต่จำเป็นต้องเปิดเผย และการผลิตยังคงต้องได้รับการอนุมัติทั้ง digital-proof และตัวอย่างผลิตภัณฑ์จริงก่อนการผลิตจำนวนมาก

## อินเทอร์เฟซ API และการเชื่อมต่อ
- **เอกสาร API เครื่องมือผู้ช่วย:** ดูจุดเชื่อมต่อปัจจุบันสำหรับการสессชันออกแบบและการตรวจสอบการรวมระบบ เอกสารอ้างอิงสาธารณะนี้ไม่ได้มอบสิทธิ์ให้บุคคลไม่ระบุตัวตนสามารถให้ราคา หรือสั่งซื้อได้ 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.
- **API ฝังสำหรับชุมชน:** เชื่อมประสบการณ์คลับ ชุมชน หรือตู้โชว์ท้องถิ่นกับการส่งมอบการออกแบบและการค้าของ 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.
- **API ซัพพลายเออร์:** เชื่อมซัพพลายเออร์ที่ได้รับอนุมัติเข้ากับการนำเข้า แคตตาล็อก การเสนอราคา และการปฏิบัติงานหลังการขาย เมื่อแบบการเป็นพันธมิตรและโมเดลการเข้าถึงได้รับการรับรองแล้ว 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.
- **API ตัวตนสำหรับองค์กร:** วางแผน 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.

## เลือกสัญญาก่อนเขียนโค้ด
- **Step 1: ทำแผนผังเส้นทางผู้ใช้:** ตัดสินใจว่าใครจะเข้ามาในเวิร์กโฟลว์และจากที่ไหน: ผู้ซื้อใน storefront ฝัง, ซัพพลายเออร์ที่อนุมัติ, ผู้ใช้ในองค์กร หรือผู้ช่วยที่ปฏิบัติการโดยมีการอนุญาตชัดเจน
- **Step 2: ยืนยันขอบเขตการเข้าถึง:** ใช้สัญญาสาธารณะเพื่อประเมินและสร้างไคลเอนต์ จากนั้นยืนยันข้อมูลรับรอง ขอบเขตสิทธิ์ สภาพแวดล้อม คอลแบ็ก และ endpoint ที่ถูกป้องกันก่อนเริ่มใช้งาน
- **Step 3: พิสูจน์ความต่อเนื่องของสถานะ:** ทดสอบให้แน่ใจว่าการออกแบบ ใบเสนอราคา การอนุมัติ ข้อผิดพลาด และการส่งต่อคำสั่งซื้อคงเป็นเวอร์ชันปัจจุบันข้ามการรวมระบบ รวมถึงเส้นทางการลองใหม่และการย้อนกลับ

## สิ่งที่การรวมระบบทุกแบบต้องรักษาไว้
- **สถานะเวอร์ชันเดียว:** การออกแบบ ความตั้งใจทางการค้า ใบเสนอราคาที่สนับสนุนโดยซัพพลายเออร์ การอนุมัติ และสถานะคำสั่งซื้อต้องเชื่อมต่อกัน การเปลี่ยนแปลงที่ล้าสมัยต้องกระตุ้นการขอราคาใหม่หรือสถานะตรวจสอบที่มองเห็นได้
- **ความเป็นส่วนตัวเชิงพาณิชย์และซัพพลายเออร์:** MerchandAise ยังคงเป็นผู้ค้าติดต่อกับผู้ซื้อและรับผิดชอบงานสนับสนุน ข้อมูลประจำตัว ที่อยู่ติดต่อ และข้อมูลภายในของซัพพลายเออร์จะไม่ถูกเปิดเผยผ่านการรวมเชิงสาธารณะ
- **การอนุมัติก่อนการผลิต:** มุมมอง 3D เฉพาะผลิตภัณฑ์และ digital proof ช่วยรองรับการตัดสินใจ แต่ไม่ทดแทนตัวอย่างผลิตภัณฑ์จริงที่ต้องได้รับการอนุมัติก่อนการผลิตจำนวนมาก

## ก่อนการไหลของการผลิตจริง
ไฟล์ OpenAPI ที่เผยแพร่เป็นพื้นผิวสำหรับการวางแผน ไม่ใช่การให้สิทธิ์เข้าถึงการผลิตโดยบุคคลไม่ระบุตัวตน เราตรวจสอบสภาพแวดล้อม ข้อมูลรับรอง การจัดการข้อผิดพลาด และความรับผิดชอบเชิงปฏิบัติการก่อนเปิดใช้งานจริง
- **การเข้าถึงและสภาพแวดล้อม:** ยืนยันเวอร์ชันสัญญา พื้นที่ทำงานที่อนุมัติ ขอบเขตการพิสูจน์ตัวตน sandbox ข้อมูลรับรองการผลิต และจุดหมายปลายทางคอลแบ็ก
- **ความล้มเหลวและการกู้คืน:** กำหนดการลองใหม่ ความไม่เปลี่ยนสถานะ (idempotency) เวลาจำกัด ข้อผิดพลาดที่มองเห็นได้สำหรับลูกค้า การสังเกตการณ์ ความรับผิดชอบฝ่ายสนับสนุน และการย้อนกลับก่อนปล่อยใช้งาน
- **หลักฐานจากต้นจนจบ:** ตรวจสอบเส้นทางที่ตั้งใจไว้ในสเตจจากการเข้าร่วม การเปลี่ยนสถานะ ผ่านใบเสนอราคา การอนุมัติ การส่งต่อ และพฤติกรรมการกู้คืน

## คำถามที่พบบ่อย
- **ฉันควรเริ่มต้นเชื่อมต่อระบบจากส่วนใด?:** เริ่มต้นด้วยบุคคลและการเปลี่ยนสถานะ (person and state transition) โดยใช้การฝังองค์ประกอบชุมชน (community embeds) สำหรับเส้นทางการใช้งานของคลับหรือชุมชนที่ติดต่อกับผู้ซื้อ, ใช้การดำเนินงานของซัพพลายเออร์ (supplier operations) สำหรับเวิร์กโฟลว์ฝั่งซัพพลายที่ได้รับการอนุมัติแล้ว, ใช้ข้อมูลระบุตัวตนระดับองค์กร (enterprise identity) สำหรับ SSO และ SCIM, และใช้เครื่องมือผู้ช่วย (assistant tooling) เฉพาะสำหรับเวิร์กโฟลว์ที่นำโดย AI ซึ่งได้รับอนุญาตอย่างชัดเจนเท่านั้น
- **สัญญาแบบสาธารณะ (public contract) หมายถึงการเข้าถึงระบบใช้งานจริง (production access) แบบสาธารณะด้วยหรือไม่?:** ไม่ใช่ สัญญา OpenAPI แบบสาธารณะมีไว้เพื่อสนับสนุนการค้นหาข้อมูล การตรวจสอบสถาปัตยกรรม และการสร้างไคลเอนต์เท่านั้น ส่วนข้อมูลการเข้าสู่ระบบใช้งานจริง (production credentials) การดำเนินการเขียนข้อมูล เวิร์กโฟลว์ของซัพพลายเออร์ ข้อมูลระบุตัวตนระดับองค์กร และการทำงานของระบบผู้ช่วย ยังคงต้องใช้พื้นที่ทำงานที่ได้รับการอนุมัติและการกำหนดสิทธิ์การเข้าถึงตามขอบเขตที่กำหนด
- **การเชื่อมต่อระบบสามารถเปิดเผยข้อมูลซัพพลายเออร์หรือข้ามขั้นตอนการอนุมัติได้หรือไม่?:** ไม่ได้ ข้อมูลระบุตัวตนและรายละเอียดการติดต่อของซัพพลายเออร์จะถูกเก็บไว้เป็นส่วนตัว เว้นแต่ในกรณีที่จำเป็นต้องเปิดเผยข้อมูล โดย MerchandAise จะเป็นผู้ดูแลความสัมพันธ์กับผู้ซื้อ และการดำเนินการใดๆ ที่ส่งผลกระทบต่อคำสั่งซื้อจะต้องผ่านขั้นตอนการอนุมัติและการตรวจสอบตัวอย่างจริงที่กำหนดไว้เสมอ

## มานำเวิร์กโฟลว์มาให้เรา ไม่ใช่สถาปัตยกรรมที่เสร็จแล้ว
บอกเราว่าใครจะใช้การรวมระบบ ส่วนใดของสถานะที่ต้องอ่านหรือเปลี่ยน และประสบการณ์จะอยู่ที่ไหน เราจะช่วยแม็พสัญญา โมเดลการเข้าถึง และเส้นทางการเปิดตัวที่ปลอดภัยให้คุณ
- **วางแผนการเชื่อมต่อ:** /th/contact?intent=api-integration-review
- **สำรวจตัวแทน AI และ MCP:** /th/developers/ai-agents-mcp