สำหรับนักพัฒนาเว็บของคลินิก
สร้างหน้าจองด้วยหน้าตาของเว็บคลินิกเอง แล้วส่งคำขอจองเข้ากล่องคำขอใน HIS ใช้บริการ ผู้รักษา เวลาว่าง และกติกาอนุมัติชุดเดียวกับหน้าจองบนเว็บของ MORRU
บริการ ผู้รักษา เวลาว่าง การอนุมัติก่อนหรืออัตโนมัติ และเวลากันช่อง ใช้ค่าที่ตั้งในหน้าจองบนเว็บคลินิกของแต่ละสาขา API จึงตอบเหมือนหน้าจองของ MORRU ทุกอย่าง
ส่งกุญแจในหัว Authorization ทุกคำขอ
Authorization: Bearer mbk_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx| ขั้น | เรียก | ได้อะไร |
|---|---|---|
| 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 /requests | 201 + สถานะคำขอ |
| 6 ติดตาม | webhook · GET /requests/{ref} | อนุมัติแล้วได้ appointmentId และ HN |
ทุกเส้นทางขึ้นต้นด้วย https://api2.morru.com/v1/booking · เวลานัดเป็นเวลาท้องถิ่นของคลินิก (ไม่มีโซนเวลา) · เวลาอื่นเป็น UTC
คลินิกตั้งจองล่วงหน้าได้ถึง 365 วัน (maxDaysAhead ใน GET /config) ถ้าจะแสดงเป็นปฏิทิน ให้ส่ง month=YYYY-MM แทน date เพื่อรู้ว่าวันไหนในเดือนนั้นยังมีคิว แล้วค่อยขอเวลาของวันที่ผู้จองเลือกด้วย date ตามเดิม
GET /slots?branch={id}&service={id}&staff={id|0}&month=2026-11{
"month": "2026-11",
"available": ["2026-11-02", "2026-11-03", "2026-11-05"]
}ข้อมูลที่คลินิกตั้งใน HIS › หน้าจองบนเว็บคลินิก และโปรไฟล์พนักงาน ใช้แสดงบนหน้าจองของเว็บคลินิกเองได้ ทุกฟิลด์เป็น null ได้ (ยกเว้นที่ระบุ) และฟิลด์ …En ที่ว่างให้ใช้ฟิลด์ภาษาไทยแทน
| ฟิลด์ | อยู่ใน | ความหมาย |
|---|---|---|
clinic.nameEn · branches[].nameEn · addressEn | GET /config | ชื่อคลินิก/สาขา/ที่อยู่ภาษาอังกฤษ · null = ใช้ชุดเดิม |
clinic.accent | GET /config | สีหน้าจอง "#rrggbb" · null = ใช้ themeColor |
clinic.coverUrl | GET /config | URL รูปปก อัตราส่วน 3:1 |
clinic.welcome · welcomeEn | GET /config | ข้อความต้อนรับ |
clinic.notice · noticeEn | GET /config | ประกาศ · เป็น null เองเมื่อเลยวันสิ้นสุดที่คลินิกตั้ง |
clinic.cancelPolicy · cancelPolicyEn | GET /config | นโยบายการยกเลิก ควรแสดงก่อนผู้จองกดยืนยัน |
branches[].photos | GET /config | URL รูปสาขา ไม่เกิน 5 รูป (อาร์เรย์ว่างเมื่อไม่มี ไม่เป็น null) |
branches[].mapUrl | GET /config | ลิงก์ Google Maps ที่คลินิกวาง หรือสร้างจากพิกัด · null เมื่อไม่มีทั้งสองอย่าง |
branches[].note · noteEn | GET /config | การเดินทาง/ที่จอดรถ |
branches[].currency | GET /config | สกุลเงินของราคา (ISO 3 ตัว ไม่เป็น null ค่าตั้งต้น "THB") |
icon | GET /services | ชื่อไอคอน Material Symbols (เช่น stethoscope) |
imageUrl | GET /services | URL รูปบริการ 1:1 · มีรูปให้ใช้รูปแทนไอคอน |
description · descriptionEn | GET /services | คำอธิบายบริการ |
durationMinutes | GET /services | ระยะเวลาโดยประมาณ (5–600 นาที) แสดงอย่างเดียว ไม่เปลี่ยนช่องเวลาใน /slots |
price | GET /services | ราคาเริ่มต้น · null เมื่อคลินิกไม่แสดงราคา · สกุลเงินตาม branches[].currency |
prep · prepEn | GET /services | คำแนะนำก่อนมา (เช่น งดอาหาร) |
staff[].specialty · specialtyEn | GET /staff | ความเชี่ยวชาญ |
staff[].languages | GET /staff | รหัสภาษาที่พูด เช่น ["th", "en"] (อาร์เรย์ว่างเมื่อไม่ตั้ง) |
staff[].bio · bioEn | GET /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 ว่าง ("") หรือไม่ส่ง |
| ฟิลด์ | อยู่ใน | ความหมาย |
|---|---|---|
mode | GET /services | "doctor" | "slot" | "day" · ไม่มีฟิลด์นี้ให้ถือเป็น doctor |
window | GET /services | { from, to } ช่วงเวลาของบริการ slot/day ("HH:mm") · null = ตามเวลาทำการสาขา |
slotMinutes | GET /services | นาทีต่อรอบของ slot · null = 30 |
day | GET /slots | เฉพาะ mode day: { from, to } ของวันนั้น หรือ null เมื่อวันนั้นปิดหรือเต็ม |
mode · dayFrom · dayTo | GET /requests/{ref} | วิธีนัดของคำขอ · day มี dayFrom/dayTo (ช่วงที่มาได้) และ appointmentAt เป็นวันนั้นเวลา dayFrom |
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" }
}'{
"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" คือบันทึกเป็นคำขอให้คลินิกติดต่อกลับ นัดยังอยู่
| type | เมื่อไร |
|---|---|
request.created | มีคำขอใหม่ (ทั้งจาก API และหน้าจองของ MORRU) |
request.approved | อนุมัติเป็นนัดแล้ว |
request.rejected | คลินิกไม่รับ |
request.expired | เลยเวลากันช่อง |
request.cancelled | ยกเลิกแล้ว |
ping | ปุ่มส่งทดสอบใน HIS (data = null) |
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": ""
}
}ทุก webhook มีหัว Morru-Signature: t={เวลา unix},v1={HMAC-SHA256 ของ "t.body" ด้วยความลับ} ดูความลับ (whsec_…) ได้ที่การ์ด API ใน HIS คำนวณจากตัว body ดิบก่อนแปลง JSON และปฏิเสธ t ที่ห่างเกิน 5 นาที
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
// $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 เมื่อข้อมูลช่องไหนผิด)
| HTTP | reason | ทำอย่างไร |
|---|---|---|
400 | invalid | ดู field แล้วแก้ข้อมูล |
400 | verify_expired | proof ของ OTP หมดอายุหรือใช้ไปแล้ว ขอรหัสใหม่ |
401 | unauthorized | กุญแจผิดหรือถูกเพิกถอน |
403 | server_only | เรียกจากเบราว์เซอร์ ย้ายไปเรียกจากเซิร์ฟเวอร์ |
404 | booking_off | คลินิกยังไม่เปิดหน้าจอง (สาขา/บริการที่ส่งมาไม่รับจองก็ได้ 404) |
409 | taken | เวลานี้ไม่ว่างแล้ว (หรือรอบ/วันนั้นเต็ม) ให้ผู้จองเลือกใหม่ |
400 · 409 | staff_service | ผู้รักษาที่เลือกไม่ได้ให้บริการนี้แล้ว (หรือส่ง staffId กับบริการ slot/day) ให้ผู้จองเลือกผู้รักษาใหม่ |
409 | too_soon | ใกล้เกินกว่าคลินิกจะอนุมัติทัน |
429 | | เกินความถี่ รอแล้วลองใหม่ |
503 | unavailable | ลองใหม่ด้วย Idempotency-Key เดิม |
ใช้หน้าจองของ MORRU ได้เลย แจกลิงก์ QR ฝังในเว็บ หรือวางปุ่มจองลอย ไม่ต้องเขียนโค้ด
คู่มือหน้าจองบนเว็บคลินิก