🔌 Headless / Public API · Developer

เชื่อมต่อ MekinPOS กับ
ทุกระบบ
ด้วย Public API

Headless Public API /api/public/v1/* ยืนยันตัวด้วย API Key แบบกำหนดสิทธิ์ (scoped) — ดึงข้อมูลเมนู ออเดอร์ ยอดขาย โปรโมชั่น และคิว (เรียลไทม์) รวมถึงสร้างออเดอร์จากระบบภายนอกได้ พร้อมเอกสาร OpenAPI และ Dev Portal ในตัว เหมาะกับการเชื่อมเว็บร้าน แอปของคุณเอง หรือระบบหลังบ้านอื่น

6scopes
OpenAPIมาตรฐาน
REST + WSเรียลไทม์
Developer API
X-API-Keyยืนยันตัว
Scopedสิทธิ์ละเอียด
Idempotentสร้างออเดอร์ปลอดภัย
120/minthrottle
ความสามารถ

ทุกอย่างที่ต้องใช้เพื่อเชื่อมต่อ

API Keys แบบ Scoped

สร้างและควบคุมสิทธิ์คีย์ได้ละเอียด

  • สร้าง/เพิกถอน API Key ที่ Dev Portal (/settings/api-keys) ได้เอง
  • เลือกสิทธิ์ทีละ scope: menu.read, orders.write, sales.read, promotions.read, queue.read
  • จำกัดอัตราการเรียก (throttle) ต่อคีย์ ป้องกันการใช้เกิน
  • ยืนยันตัวด้วยส่วนหัว X-API-Key ทุกคำขอ
API Keys
อ่านข้อมูล (Read)

ดึงข้อมูลร้านไปแสดงที่ไหนก็ได้

  • GET /menu — เมนู หมวดหมู่ ตัวเลือก และราคาต่อช่องทาง
  • GET /sales · GET /orders — ยอดขายและออเดอร์สำหรับแดชบอร์ดของคุณ
  • GET /promotions — โปรโมชั่น 5 ชนิด + รูปเมนู + เงื่อนไข
  • GET /queue — คิวเรียลไทม์ แยกตามช่องทาง (by channel)
Read API
เขียนออเดอร์ (Write)

รับออเดอร์จากช่องทางภายนอกได้ปลอดภัย

  • POST /orders reuse เอนจินเดียวกับหน้าร้าน
  • คิดราคา ตัวเลือก โปรโมชั่น และ VAT ให้ครบเหมือนขายจริง
  • ตรวจเพดานแพลนและรองรับ idempotency ป้องกันออเดอร์ซ้ำ
  • เหมาะกับเว็บสั่งอาหารเอง มาร์เก็ตเพลส หรือระบบพันธมิตร
Write API
เรียลไทม์ (WebSocket)

ทำจอคิวและสถานะสดบนเว็บของคุณเอง

  • endpoint คิวส่งพร้อม meta.realtime สำหรับต่อ WebSocket
  • ช่อง WS queue.{tenant} events queue.called / queue.changed
  • หรือจะ poll ก็ได้ ถ้าไม่ต้องการเชื่อม WebSocket
  • สร้างจอเรียกคิว หรือสถานะออเดอร์สดบนหน้าเว็บของคุณ
Realtime WebSocket
OpenAPI + Dev Portal

เริ่มพัฒนาได้ทันทีด้วยเอกสารมาตรฐาน

  • GET /openapi.json สเปคมาตรฐาน นำเข้า Postman / Swagger ได้
  • Dev Portal /settings/api มีเอกสารทุก endpoint
  • ตัวจัดการ key ครบ สร้าง เพิกถอน และดูสิทธิ์ในที่เดียว
  • ตัวอย่างคำขอและรูปแบบผลลัพธ์พร้อมคัดลอกใช้งาน
OpenAPI Dev Portal
เริ่มต้นใน 1 บรรทัด

คำขอแรกของคุณ

แนบ API Key ผ่านส่วนหัว X-API-Key แล้วเรียก endpoint ได้ทันที

curl https://mekinpos.com/api/public/v1/menu \
  -H "X-API-Key: mkp_live_xxx"
ทำไมนักพัฒนาถึงชอบ

ออกแบบมาเพื่อนักพัฒนา

🧩

ต่อกับอะไรก็ได้

เว็บร้าน แอปของคุณเอง หรือระบบหลังบ้าน เชื่อมเข้ากับ MekinPOS ได้ด้วย REST มาตรฐาน

🔐

ปลอดภัย

API Key แบบ scoped + idempotency สร้างออเดอร์ปลอดภัย + throttle จำกัดอัตราเรียกต่อคีย์

📡

เรียลไทม์

คิวและสถานะผ่าน WebSocket พร้อมสเปค OpenAPI นำเข้า Postman/Swagger ได้ทันที

อยากเชื่อมระบบของคุณกับ MekinPOS?

Headless Public API เปิดใช้งานตามแพ็กเกจ (ฟีเจอร์ menu_api / developer API scope) — คุยกับเราเพื่อเปิดใช้งาน

ระบบอื่นในตระกูล MekinPOS