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

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

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

## รักษาแหล่งข้อมูลหลักเพียงชุดเดียว
การรวมระบบควรขยายเวิร์กโฟลว์ของ MerchandAise ไม่ใช่แยกแหล่งข้อมูล ผู้ใช้งานจากเว็บไซต์ ฝังชุมชน ฝั่งซัพพลายเออร์ องค์กร หรือผู้ช่วย ต้องอ่านและอัพเดตการออกแบบ ความตั้งใจทางการค้า ใบเสนอราคา การอนุมัติ และสถานะคำสั่งซื้อที่มีเวอร์ชันเดียวกัน
Where MerchandAise processes the buyer transaction, Hutter Products GmbH is the contracting seller and Merchant of Record under the MerchandAise brand. Supplier identity and contact details stay private except where disclosure is required, and production still requires digital-proof approval, confirmed producibility, mandatory technical checks, and the sample approvals applicable to the exact accepted order.

## อินเทอร์เฟซ API และการเชื่อมต่อ
- **เอกสาร API เครื่องมือผู้ช่วย:** ดูจุดเชื่อมต่อปัจจุบันสำหรับการสессชันออกแบบและการตรวจสอบการรวมระบบ เอกสารอ้างอิงสาธารณะนี้ไม่ได้มอบสิทธิ์ให้บุคคลไม่ระบุตัวตนสามารถให้ราคา หรือสั่งซื้อได้ Human guide: ดูเอกสารเครื่องมือผู้ช่วย (/th/developers/api-integrations). Machine-readable contract: OpenAPI JSON ของเครื่องมือผู้ช่วย (/api/docs/openapi.json). การเข้าถึง: สาธารณะ. เอกสารอ้างอิงสาธารณะสำหรับ 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). การเข้าถึง: สาธารณะ. สัญญาเวอร์ชันสาธารณะสำหรับการฝัง 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). การเข้าถึง: สาธารณะ. สัญญาสาธารณะเพื่อการวางแผนและการสร้างไคลเอนต์ การเข้าถึงเชิงปฏิบัติการสำหรับซัพพลายเออร์ยังคงต้องได้รับสิทธิ์ 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). การเข้าถึง: มีการป้องกัน. สัญญาที่ได้รับการป้องกันสำหรับพื้นที่ทำงานองค์กรที่ได้รับอนุมัติ; กรุณาขอการเข้าถึงก่อนใช้งาน endpoint นี้ Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations.

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

## สิ่งที่การรวมระบบทุกแบบต้องรักษาไว้
- **สถานะเวอร์ชันเดียว:** การออกแบบ ความตั้งใจทางการค้า ใบเสนอราคาที่สนับสนุนโดยซัพพลายเออร์ การอนุมัติ และสถานะคำสั่งซื้อต้องเชื่อมต่อกัน การเปลี่ยนแปลงที่ล้าสมัยต้องกระตุ้นการขอราคาใหม่หรือสถานะตรวจสอบที่มองเห็นได้
- **ความเป็นส่วนตัวเชิงพาณิชย์และซัพพลายเออร์:** MerchandAise ยังคงเป็นผู้ค้าติดต่อกับผู้ซื้อและรับผิดชอบงานสนับสนุน ข้อมูลประจำตัว ที่อยู่ติดต่อ และข้อมูลภายในของซัพพลายเออร์จะไม่ถูกเปิดเผยผ่านการรวมเชิงสาธารณะ
- **การอนุมัติก่อนการผลิต:** A 3D view is not physical evidence. The confirmed quote explains any available customer-sample choices, costs, limitations, and timing. Approve the exact digital proof and complete mandatory technical checks and any required or selected sample approval before mass production. Existing accepted-order requirements remain binding.

## ก่อนการไหลของการผลิตจริง
ไฟล์ 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) การดำเนินการเขียนข้อมูล เวิร์กโฟลว์ของซัพพลายเออร์ ข้อมูลระบุตัวตนระดับองค์กร และการทำงานของระบบผู้ช่วย ยังคงต้องใช้พื้นที่ทำงานที่ได้รับการอนุมัติและการกำหนดสิทธิ์การเข้าถึงตามขอบเขตที่กำหนด
- **การเชื่อมต่อระบบสามารถเปิดเผยข้อมูลซัพพลายเออร์หรือข้ามขั้นตอนการอนุมัติได้หรือไม่?:** No. Supplier identity and contact details remain private except where disclosure is required, MerchandAise owns the buyer relationship, and order-affecting actions must preserve the configured digital-proof, technical, and order-specific sample approval requirements.

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