Developer Docs

    เริ่มต้น

    Partner API — Auth

    Partner API — Sales

    Partner API — Products

    Partner API — Inventory

    Partner API — Purchasing

    Partner API — Customers

    Partner API — Reports

    Partner API — Webhooks

    อ้างอิง

    Webhooks Overview

    Webhooks ช่วยให้ระบบของคุณรับข้อมูลเหตุการณ์จาก MeeD แบบ Real-time โดยไม่ต้องทำการ Poll API ซ้ำ

    เมื่อเหตุการณ์เกิดขึ้นในระบบ MeeD เช่น มีการขายสินค้าสำเร็จ หรือ Stock ต่ำกว่าจุด Reorder — MeeD จะส่ง HTTP POST ไปยัง endpoint_url ที่คุณกำหนดไว้ทันที

    How It Works

    1. ไปที่ Settings → Open API แล้วสร้าง Webhook Subscription โดยระบุ endpoint_url และ event_types ที่ต้องการรับ
    2. MeeD จะส่ง HTTP POST ไปยัง Endpoint ของคุณทุกครั้งที่ Event เกิดขึ้น
    3. ตรวจสอบ X-MeeD-Signature header เพื่อยืนยันว่า Request มาจาก MeeD จริง — ดู Payload & Signatures
    4. ตอบกลับ 2xx เพื่อยืนยันว่าได้รับ Event แล้ว — หากไม่ตอบ MeeD จะ Retry อัตโนมัติ

    Webhook Flow

    Event Catalog

    ระบุ Event Type ที่ต้องการรับใน event_types array — สามารถเลือกหลาย Event ได้ในหนึ่ง Subscription

    Event Typeเกิดขึ้นเมื่อ
    sales.order.createdสร้าง Sales Order ใหม่
    sales.order.updatedSales Order มีการเปลี่ยนแปลง Status หรือรายละเอียด
    sales.order.completedOrder Status เปลี่ยนเป็น COMPLETED
    sales.order.cancelledOrder Status เปลี่ยนเป็น CANCELLED
    sales.order.refundedมีการ Refund เกิดขึ้นบน Order
    inventory.movement.createdมีการบันทึก Inventory Movement
    inventory.stock.lowStock ของ SKU ลดลงถึงหรือต่ำกว่า reorder_point
    products.createdสร้าง Product ใหม่
    products.updatedProduct หรือ SKU มีการเปลี่ยนแปลง
    customers.createdสร้าง Customer ใหม่
    customers.updatedข้อมูล Customer มีการเปลี่ยนแปลง
    purchase_orders.createdสร้าง Purchase Order ใหม่
    purchase_orders.updatedPO มีการเปลี่ยนแปลง Status หรือรายละเอียด
    purchase_orders.receivedรับสินค้าจาก PO (PARTIALLY_RECEIVED หรือ FULLY_RECEIVED)

    WebhookSubscription Object

    Object นี้ถูกคืนจากทุก Webhook Endpoint ยกเว้น signing_secret ซึ่งแสดงเฉพาะตอนสร้างเท่านั้น

    FieldTypeDescription
    idstring (UUID)Webhook Subscription ID
    endpoint_urlstringURL ปลายทางที่รับ Event
    event_typesstring[]รายการ Event Type ที่ Subscribe
    statusstringสถานะ Subscription: ACTIVE, PAUSED, DISABLED
    signing_secretstring64-char hex — แสดงเฉพาะตอนสร้างใน Settings → Open API เท่านั้น
    created_atstring (ISO 8601)เวลาที่สร้าง
    updated_atstring (ISO 8601)เวลาที่แก้ไขล่าสุด

    Subscription Status

    StatusDescription
    ACTIVEรับ Event และส่ง Delivery ปกติ
    PAUSEDหยุดรับ Event ชั่วคราว — Event ที่เกิดขึ้นจะไม่ถูกส่ง
    DISABLEDถูกปิดถาวร — ไม่สามารถเปิดใช้งานอีกได้