Morru
หน้าแรก
แพ็คเกจและราคา
คู่มือการใช้งาน
คำถามที่พบบ่อย
ติดต่อเรา
เข้าสู่ระบบ
สำหรับบุคคลทั่วไป→
THAENG
˄ เลื่อนขึ้น
เลื่อนลง ˅
เข้าสู่ระบบ||THAENG
Morru
หน้าแรก
แพ็คเกจและราคา
ฟีเจอร์
  • •ฟีเจอร์ทั้งหมด
  • •โมดูลเฉพาะทาง
  • •โมดูลศัลยกรรมกระดูก
  • •โมดูลกายภาพบำบัด
  • •โมดูลทันตกรรม
  • •ดูแลคนไข้ (CRM) ผ่าน LINE
คู่มือการใช้งาน
คำถามที่พบบ่อย
ติดต่อเรา
สำหรับบุคคลทั่วไป →
หน้าแรก›API จองคิว

สำหรับนักพัฒนาเว็บของคลินิก

API จองคิว ให้เว็บของคลินิกรับนัดเข้า MORRU HIS โดยตรง

สร้างหน้าจองด้วยหน้าตาของเว็บคลินิกเอง แล้วส่งคำขอจองเข้ากล่องคำขอใน HIS ใช้บริการ ผู้รักษา เวลาว่าง และกติกาอนุมัติชุดเดียวกับหน้าจองบนเว็บของ MORRU

ดาวน์โหลดสเปก OpenAPI ↓ไฟล์ OpenAPI 3.1 สำหรับ Postman, Insomnia หรือสร้างโค้ดฝั่งลูกค้า
แพ็กเกจ
Starter ขึ้นไป
ยืนยันตัวตน
กุญแจลับ
รูปแบบ
JSON · HTTPS
แจ้งผล
Webhook

ในหน้านี้

  1. เริ่มต้น
  2. กุญแจและความปลอดภัย
  3. ลำดับการจอง
  4. วันว่างทั้งเดือน
  5. ฟิลด์หน้าตาและข้อมูลประกอบ
  6. วิธีนัดของบริการ
  7. ส่งคำขอจอง
  8. สถานะและการยกเลิก
  9. Webhook
  10. ตรวจลายเซ็น
  11. ข้อผิดพลาด

เริ่มต้น

  • แพ็กเกจ Starter ขึ้นไป และเปิดรับจองของสาขาที่ HIS › ตั้งค่าระบบ › จัดการสาขา › หน้าจองบนเว็บคลินิก
  • สร้างกุญแจ API ในการ์ด "API สำหรับเว็บของคลินิก" หน้าเดียวกัน กุญแจแสดงครั้งเดียว เก็บไว้ในเซิร์ฟเวอร์ของเว็บ
  • ใส่ URL ของ webhook ถ้าต้องการรับแจ้งเมื่อคำขอถูกอนุมัติ ไม่รับ หมดเวลา หรือยกเลิก

บริการ ผู้รักษา เวลาว่าง การอนุมัติก่อนหรืออัตโนมัติ และเวลากันช่อง ใช้ค่าที่ตั้งในหน้าจองบนเว็บคลินิกของแต่ละสาขา API จึงตอบเหมือนหน้าจองของ MORRU ทุกอย่าง

กุญแจและความปลอดภัย

ส่งกุญแจในหัว Authorization ทุกคำขอ

HTTP
Authorization: Bearer mbk_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  • เรียกจากเซิร์ฟเวอร์เท่านั้น คำขอที่มีหัว Origin (มาจากเบราว์เซอร์) ได้ 403 ห้ามใส่กุญแจในหน้าเว็บหรือแอป
  • กุญแจผิดหรือถูกเพิกถอนได้ 401 · เพิกถอนใน HIS แล้วใช้ไม่ได้ทันที
  • จำกัดความถี่ต่อกุญแจ: อ่าน 300 ครั้ง/นาที · เขียน 60 ครั้ง/นาที · เกินได้ 429
  • คลินิกเป็นผู้ควบคุมข้อมูลตาม PDPA เก็บความยินยอมของผู้จองบนเว็บของตัวเองก่อนส่งคำขอ MORRU เป็นผู้ประมวลผล

ลำดับการจอง

ขั้นเรียกได้อะไร
1 สาขาGET /configสาขาที่รับจอง (id) · วิธียืนยันที่เปิด · โหมดอนุมัติ · จองล่วงหน้าได้กี่วัน
2 บริการGET /services?branch={id}[{ id, name, nameEn, … }] (ฟิลด์หน้าตาดูหัวข้อถัดไป)
3 ผู้รักษาGET /staff?branch={id}&service={id}{ allowAny, staff: [{ id, name, … }] } · allowAny = จองแบบไม่ระบุได้ (staffId 0) · ข้ามขั้นนี้เมื่อบริการเป็น mode slot หรือ day
4 เวลาGET /slots?branch=&service=&staff=&date=YYYY-MM-DD{ date, times: ["09:00", …] } เฉพาะเวลาที่ว่างและคลินิกอนุมัติทัน · บริการ mode day ได้ times ว่างและ day: { from, to }
5 ส่งคำขอPOST /requests201 + สถานะคำขอ
6 ติดตามwebhook · GET /requests/{ref}อนุมัติแล้วได้ appointmentId และ HN

ทุกเส้นทางขึ้นต้นด้วย https://api2.morru.com/v1/booking · เวลานัดเป็นเวลาท้องถิ่นของคลินิก (ไม่มีโซนเวลา) · เวลาอื่นเป็น UTC

วันว่างทั้งเดือน

คลินิกตั้งจองล่วงหน้าได้ถึง 365 วัน (maxDaysAhead ใน GET /config) ถ้าจะแสดงเป็นปฏิทิน ให้ส่ง month=YYYY-MM แทน date เพื่อรู้ว่าวันไหนในเดือนนั้นยังมีคิว แล้วค่อยขอเวลาของวันที่ผู้จองเลือกด้วย date ตามเดิม

HTTP
GET /slots?branch={id}&service={id}&staff={id|0}&month=2026-11
JSON
{
  "month": "2026-11",
  "available": ["2026-11-02", "2026-11-03", "2026-11-05"]
}
  • available มีเฉพาะวันในช่วงที่จองได้ (วันนี้ถึงวันนี้ + maxDaysAhead) ที่มีเวลาว่างอย่างน้อยหนึ่งช่วง เรียงตามวัน · ไม่มีวันว่าง = อาร์เรย์ว่าง
  • บริการ mode day: วันที่ผู้จองมาได้ (วันที่ GET /slots?date= ได้ day ไม่เป็น null)
  • ส่ง date หรือ month อย่างใดอย่างหนึ่ง · ขอทีละเดือน และเก็บผลไว้ใช้ซ้ำตามเดือน สาขา บริการ และผู้รักษา

ฟิลด์หน้าตาและข้อมูลประกอบ

ข้อมูลที่คลินิกตั้งใน HIS › หน้าจองบนเว็บคลินิก และโปรไฟล์พนักงาน ใช้แสดงบนหน้าจองของเว็บคลินิกเองได้ ทุกฟิลด์เป็น null ได้ (ยกเว้นที่ระบุ) และฟิลด์ …En ที่ว่างให้ใช้ฟิลด์ภาษาไทยแทน

ฟิลด์อยู่ในความหมาย
clinic.nameEn · branches[].nameEn · addressEnGET /configชื่อคลินิก/สาขา/ที่อยู่ภาษาอังกฤษ · null = ใช้ชุดเดิม
clinic.accentGET /configสีหน้าจอง "#rrggbb" · null = ใช้ themeColor
clinic.coverUrlGET /configURL รูปปก อัตราส่วน 3:1
clinic.welcome · welcomeEnGET /configข้อความต้อนรับ
clinic.notice · noticeEnGET /configประกาศ · เป็น null เองเมื่อเลยวันสิ้นสุดที่คลินิกตั้ง
clinic.cancelPolicy · cancelPolicyEnGET /configนโยบายการยกเลิก ควรแสดงก่อนผู้จองกดยืนยัน
branches[].photosGET /configURL รูปสาขา ไม่เกิน 5 รูป (อาร์เรย์ว่างเมื่อไม่มี ไม่เป็น null)
branches[].mapUrlGET /configลิงก์ Google Maps ที่คลินิกวาง หรือสร้างจากพิกัด · null เมื่อไม่มีทั้งสองอย่าง
branches[].note · noteEnGET /configการเดินทาง/ที่จอดรถ
branches[].currencyGET /configสกุลเงินของราคา (ISO 3 ตัว ไม่เป็น null ค่าตั้งต้น "THB")
iconGET /servicesชื่อไอคอน Material Symbols (เช่น stethoscope)
imageUrlGET /servicesURL รูปบริการ 1:1 · มีรูปให้ใช้รูปแทนไอคอน
description · descriptionEnGET /servicesคำอธิบายบริการ
durationMinutesGET /servicesระยะเวลาโดยประมาณ (5–600 นาที) แสดงอย่างเดียว ไม่เปลี่ยนช่องเวลาใน /slots
priceGET /servicesราคาเริ่มต้น · null เมื่อคลินิกไม่แสดงราคา · สกุลเงินตาม branches[].currency
prep · prepEnGET /servicesคำแนะนำก่อนมา (เช่น งดอาหาร)
staff[].specialty · specialtyEnGET /staffความเชี่ยวชาญ
staff[].languagesGET /staffรหัสภาษาที่พูด เช่น ["th", "en"] (อาร์เรย์ว่างเมื่อไม่ตั้ง)
staff[].bio · bioEnGET /staffประวัติย่อ

วิธีนัดของบริการ

คลินิกตั้งวิธีนัดรายบริการใน HIS › หน้าจองบนเว็บคลินิก ทุกบริการใน GET /services มี mode บอกว่าหน้าจองต้องถามอะไรบ้าง

modeขั้นที่ใช้ส่งคำขอ
doctorเลือกผู้รักษา (GET /staff) แล้วเลือกเวลา (GET /slots) · ค่าตั้งต้นstaffId ที่เลือกหรือ 0 · time
slotไม่ต้องพบแพทย์ ไม่มีขั้นผู้รักษา · เลือกรอบเวลาจาก GET /slots (staff=0) รอบละ slotMinutes นาที รับได้หลายคนต่อรอบstaffId 0 · time
dayไม่ต้องนัดเวลา เลือกแค่วัน · GET /slots (staff=0) ได้ day: { from, to } = ช่วงที่มาได้ · day เป็น null = วันนั้นไม่รับstaffId 0 · time ว่าง ("") หรือไม่ส่ง
ฟิลด์อยู่ในความหมาย
modeGET /services"doctor" | "slot" | "day" · ไม่มีฟิลด์นี้ให้ถือเป็น doctor
windowGET /services{ from, to } ช่วงเวลาของบริการ slot/day ("HH:mm") · null = ตามเวลาทำการสาขา
slotMinutesGET /servicesนาทีต่อรอบของ slot · null = 30
dayGET /slotsเฉพาะ mode day: { from, to } ของวันนั้น หรือ null เมื่อวันนั้นปิดหรือเต็ม
mode · dayFrom · dayToGET /requests/{ref}วิธีนัดของคำขอ · day มี dayFrom/dayTo (ช่วงที่มาได้) และ appointmentAt เป็นวันนั้นเวลา dayFrom
  • บริการแบบรวมหลายสาขา (GET /services ไม่ระบุ branch) ใช้ mode ของสาขาแรก วิธีนัดตั้งรายสาขาจึงต่างกันได้ เลือกสาขาแล้วให้อ่าน mode จาก GET /services?branch={id}
  • บริการแบบ doctor แสดงเฉพาะผู้รักษาที่คลินิกตั้งให้ทำบริการนั้นได้ ส่ง staffId ของคนที่ไม่ได้ให้บริการนี้จะถูกปฏิเสธด้วย reason staff_service

ส่งคำขอจอง

Terminal · curl
curl -X POST https://api2.morru.com/v1/booking/requests \
  -H "Authorization: Bearer $MORRU_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1001" \
  -d '{
    "branch": "a8eqdoh0gggp",
    "serviceId": 65,
    "staffId": 0,
    "date": "2026-10-24",
    "time": "10:00",
    "firstName": "สมใจ",
    "lastName": "ใจดี",
    "phone": "0812345678",
    "email": "somjai@example.com",
    "note": "ปวดหลัง 2 สัปดาห์",
    "consent": true,
    "externalRef": "WEB-1001",
    "verify": { "method": "clinic" }
  }'
  • verify.method = "clinic" — คลินิกยืนยันตัวผู้จองเอง (เช่นสมาชิกที่ล็อกอินเว็บคลินิกแล้ว) ตัวตนที่บันทึกคือเบอร์ที่ส่งมา
  • หรือใช้ OTP ของ MORRU: POST /otp { branch, channel: "email"|"sms", target } → ผู้จองได้รหัส 6 หลัก → POST /otp/verify { branch, channel, target, code } ได้ proof → ส่ง verify { method, target, proof } ภายใน 30 นาที
  • consent ต้องเป็น true · externalRef = รหัสฝั่งเว็บคลินิก (ไม่เกิน 100 ตัว) ได้คืนในสถานะและ webhook
  • Idempotency-Key (8–64 ตัว A-Z a-z 0-9 _ . : -) ส่งซ้ำด้วยคีย์เดิมได้ 200 พร้อมคำขอเดิม ไม่สร้างซ้ำ ใช้เมื่อเน็ตหลุดแล้วไม่แน่ใจว่าส่งถึงหรือยัง
คำตอบ 201 — รูปเดียวกับ GET /requests/{ref}
JSON
{
  "ref": "4pomwjm1iqh4",
  "externalRef": "WEB-1001",
  "source": "api",
  "status": "pending",
  "approveMode": "manual",
  "branch": { "id": "a8eqdoh0gggp", "name": "สาขาหลัก" },
  "service": { "id": 65, "name": "นัดมาพบแพทย์ครั้งแรก", "nameEn": "First visit" },
  "staff": null,
  "appointmentAt": "2026-10-24T10:00",
  "durationMinutes": 15,
  "mode": "doctor",
  "patient": {
    "firstName": "สมใจ", "lastName": "ใจดี", "phone": "0812345678",
    "email": "somjai@example.com", "note": "ปวดหลัง 2 สัปดาห์", "verifiedBy": "clinic"
  },
  "holdUntil": "2026-10-22T02:05:47Z",
  "createdAt": "2026-10-21T14:05:47Z",
  "decidedAt": "",
  "appointmentId": null,
  "hn": "",
  "rejectReason": ""
}

สถานะและการยกเลิก

statusความหมาย
pendingรอคลินิก (โหมดอนุมัติก่อน) หรือระบบกำลังยืนยัน (อัตโนมัติ) · กันช่องไว้ถึง holdUntil
approvedเป็นนัดในปฏิทินแล้ว มี appointmentId และ hn
rejectedคลินิกไม่รับ พร้อม rejectReason
expiredเลยเวลากันช่องโดยยังไม่อนุมัติ ช่องว่างให้คนอื่นจองได้
cancelledยกเลิกแล้ว

POST /requests/{ref}/cancel ยกเลิกแทนผู้จอง — รอคลินิกอยู่ = ยกเลิกทันที · อนุมัติแล้วใช้กติกาเดียวกับการยกเลิกทาง LINE (ยังไม่ชำระ ยังไม่เข้าคิว และเหลือเวลาก่อนนัดตามที่สาขาตั้ง) ไม่ผ่านจะได้ result: "asked" คือบันทึกเป็นคำขอให้คลินิกติดต่อกลับ นัดยังอยู่

Webhook

typeเมื่อไร
request.createdมีคำขอใหม่ (ทั้งจาก API และหน้าจองของ MORRU)
request.approvedอนุมัติเป็นนัดแล้ว
request.rejectedคลินิกไม่รับ
request.expiredเลยเวลากันช่อง
request.cancelledยกเลิกแล้ว
pingปุ่มส่งทดสอบใน HIS (data = null)
HTTP
POST /hooks/morru HTTP/1.1
Content-Type: application/json
User-Agent: MORRU-Webhooks/1.0
Morru-Event-Id: evt_dba40d57c29e42228edd
Morru-Signature: t=1761055547,v1=5f0c…

{
  "id": "evt_dba40d57c29e42228edd",
  "type": "request.approved",
  "createdAt": "2026-10-21T14:10:02Z",
  "data": {
    "ref": "4pomwjm1iqh4",
    "externalRef": "WEB-1001",
    "source": "api",
    "status": "approved",
    "branch": "a8eqdoh0gggp",
    "appointmentAt": "2026-10-24T10:00",
    "appointmentId": 48213,
    "hn": "SKV2600123",
    "rejectReason": ""
  }
}
  • ตอบ 2xx ภายใน 10 วินาที แล้วค่อยประมวลผลทีหลัง · ตอบอื่นหรือไม่ตอบ ระบบส่งใหม่หลัง 1 min · 5 min · 30 min · 2 h · 6 h · 12 h แล้วเลิก
  • อาจได้เหตุการณ์เดียวกันซ้ำ ใช้ id (Morru-Event-Id) กันประมวลผลซ้ำ · ลำดับที่มาถึงอาจสลับ ใช้ data.status ล่าสุดจาก GET /requests/{ref} เมื่อสงสัย
  • URL ต้องเป็น https พอร์ต 443 บนโดเมนสาธารณะ · ระบบไม่ตาม redirect
  • data ไม่มีชื่อหรือเบอร์ของผู้จอง ดูเต็มที่ GET /requests/{ref}

ตรวจลายเซ็น

ทุก webhook มีหัว Morru-Signature: t={เวลา unix},v1={HMAC-SHA256 ของ "t.body" ด้วยความลับ} ดูความลับ (whsec_…) ได้ที่การ์ด API ใน HIS คำนวณจากตัว body ดิบก่อนแปลง JSON และปฏิเสธ t ที่ห่างเกิน 5 นาที

Node.js
import crypto from "node:crypto";

// rawBody = ตัว body ดิบ (string) ก่อน JSON.parse · secret = whsec_… จาก HIS
export function verifyMorru(rawBody, header, secret) {
  const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  const age = Math.abs(Date.now() / 1000 - Number(parts.t));
  if (!parts.t || !parts.v1 || age > 300) return false;
  const expected = crypto.createHmac("sha256", secret).update(`${parts.t}.${rawBody}`).digest("hex");
  return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1));
}
PHP
<?php
// $raw = file_get_contents('php://input') · $secret = whsec_… จาก HIS
function verify_morru(string $raw, string $header, string $secret): bool {
    parse_str(str_replace(',', '&', $header), $p);
    if (empty($p['t']) || empty($p['v1']) || abs(time() - (int)$p['t']) > 300) return false;
    $expected = hash_hmac('sha256', $p['t'] . '.' . $raw, $secret);
    return hash_equals($expected, $p['v1']);
}

ตัวอย่างทดสอบโค้ด: ความลับ whsec_test · t 1700000000 · body {"a":1} → t=1700000000,v1=38877139021993b830af32feea6e18a8da83eb2f6e49ee50bd9e4cf4ca4d3789

ข้อผิดพลาด

คำตอบที่ไม่สำเร็จเป็น JSON { reason, message } (และ field เมื่อข้อมูลช่องไหนผิด)

HTTPreasonทำอย่างไร
400invalidดู field แล้วแก้ข้อมูล
400verify_expiredproof ของ OTP หมดอายุหรือใช้ไปแล้ว ขอรหัสใหม่
401unauthorizedกุญแจผิดหรือถูกเพิกถอน
403server_onlyเรียกจากเบราว์เซอร์ ย้ายไปเรียกจากเซิร์ฟเวอร์
404booking_offคลินิกยังไม่เปิดหน้าจอง (สาขา/บริการที่ส่งมาไม่รับจองก็ได้ 404)
409takenเวลานี้ไม่ว่างแล้ว (หรือรอบ/วันนั้นเต็ม) ให้ผู้จองเลือกใหม่
400 · 409staff_serviceผู้รักษาที่เลือกไม่ได้ให้บริการนี้แล้ว (หรือส่ง staffId กับบริการ slot/day) ให้ผู้จองเลือกผู้รักษาใหม่
409too_soonใกล้เกินกว่าคลินิกจะอนุมัติทัน
429เกินความถี่ รอแล้วลองใหม่
503unavailableลองใหม่ด้วย Idempotency-Key เดิม

ไม่มีนักพัฒนา?

ใช้หน้าจองของ MORRU ได้เลย แจกลิงก์ QR ฝังในเว็บ หรือวางปุ่มจองลอย ไม่ต้องเขียนโค้ด

คู่มือหน้าจองบนเว็บคลินิก →
  • •หน้าแรก
  • •แพ็คเกจและราคา
  • •ฟีเจอร์
  • •คู่มือการใช้งาน
  • •คำถามที่พบบ่อย
  • •ติดต่อเรา
  • •ข้อกำหนดการใช้งาน
  • •นโยบายความเป็นส่วนตัว
  • •ความปลอดภัยและ PDPA
  • •ศูนย์ช่วยเหลือ
Morru

บริษัท เครซี่โค้ด จำกัด

300/45 ซอยลาดพร้าว 84 (สังคมสงเคราะห์ใต้ 1)

แขวงวังทองหลาง กรุงเทพมหานคร 10310

Morru

บริษัท เครซี่โค้ด จำกัด

300/45 ซอยลาดพร้าว 84 (สังคมสงเคราะห์ใต้ 1)

แขวงวังทองหลาง กรุงเทพมหานคร 10310

หน้าแรก
แพ็คเกจและราคา
ฟีเจอร์
คู่มือการใช้งาน
คำถามที่พบบ่อย
ติดต่อเรา

2026 © All Rights Reserved

ข้อกำหนดการใช้งานนโยบายความเป็นส่วนตัวความปลอดภัยและ PDPAศูนย์ช่วยเหลือ