ครอบคลุมทุกงานในคลินิก
ทำอะไรผ่าน API ได้บ้าง
ทุกงานที่ทำในหน้าโปรแกรม ทำผ่าน API ได้ทั้งอ่านและเขียน — แบ่งเป็น 11 หมวดธุรกิจ แต่ละหมวดมีตัวอย่าง endpoint และลิงก์ไปหน้าเอกสารที่มีพารามิเตอร์ ตัวอย่าง request/response ครบ
ลูกค้า & CRM
ข้อมูลลูกค้าครบทุกมิติ ใช้ร่วมกันทุกสาขาในเครือ
- สร้าง/แก้ไขลูกค้า ออก HN อัตโนมัติ ตรวจเลขบัตรประชาชนซ้ำทุกสาขา
- ประวัติการรักษา นัดหมาย ผลตรวจ แพ้ยา สิทธิ์การรักษา และไฟล์แนบ
- กลุ่มลูกค้า แท็ก วงเงิน (coin) และไปป์ไลน์การขาย
- วิเคราะห์รายคน — ความถี่การมา แนวโน้มการใช้จ่าย ความเสี่ยงหาย
POST/customerGET/customer/citizen/{citizenId}GET/customer/analytics/{customerId}ดูในเอกสาร93 endpointนัดหมาย & คิว
ตั้งแต่จองนัดจนลูกค้าเดินออกจากคลินิก
- สร้าง/ค้นหา/ยืนยัน/ยกเลิกนัด ดูตารางแพทย์และช่วงเวลาว่าง
- เปิดคิว (เช็คอิน) เปลี่ยนสถานะ ยกเลิก และบันทึกเพิ่มเติมของคิว
- สั่งยา ตรวจ Lab/X-Ray และตัดคอร์สลงในคิว
- ภาพรวมคลินิกแบบสด — ห้อง เตียง คิววันนี้ แพทย์เข้าเวร
เวชระเบียน & การรักษา
OPD · IPD · ER · ผ่าตัด · แผนไทย · เทเลเมดิซีน
- OPD ทั่วไป ทันตกรรม จักษุ กระดูกและข้อ และแบบฟอร์ม OPD ที่ร้านออกแบบเอง
- ผู้ป่วยใน: Admit · Vital Signs · Nursing note · MAR · ย้ายเตียง · จำหน่าย
- ห้องฉุกเฉิน ตารางผ่าตัด/วิสัญญี แพทย์แผนไทย เทเลเมดิซีน
- รหัสวินิจฉัย ICD และใบรับรองแพทย์
POST/ipd/admitGET/opdDental/customer/{customerId}POST/{shopId}/thai-med/consultationsดูในเอกสาร192 endpointตรวจ แล็บ & ตรวจสุขภาพ
เชื่อมเครื่องแล็บ/LIS และงานตรวจสุขภาพองค์กร
- รายการตรวจ ชุดตรวจ และราคาตามสิทธิ์
- บันทึกผลแล็บ/X-Ray กลับเข้าคิว พร้อมค่าอ้างอิงและรูปผลตรวจ
- แฟ้มตรวจสุขภาพ — รวมผลจากคิวเป็นเล่ม ออกเลขที่ สร้างอัตโนมัติตามช่วงวันที่
- บริษัท/นายจ้างและนำเข้ารายชื่อพนักงาน
ขาย · ใบแจ้งหนี้ · ใบเสร็จ
เอกสารการเงินครบชุด พร้อมส่งต่อระบบบัญชี
- รายการขาย ใส่ยา/คอร์ส/ตรวจ/วงเงิน และส่วนลด
- ใบแจ้งหนี้ ใบเสร็จ ใบกำกับภาษี ใบลดหนี้ — ค้นหา พิมพ์ ยกเลิก
- ขายด่วน: ออกรายการขาย + ใบแจ้งหนี้ในครั้งเดียว
- ค่าใช้จ่ายของร้าน และส่งข้อมูลเข้า PEAK
คอร์ส & การใช้บริการ
ขายคอร์สเป็นครั้ง ตัดคอร์ส และติดตามคงเหลือ
- ข้อมูลคอร์ส ชุดคอร์ส นำเข้า Excel และซิงค์จากร้านแม่ไปสาขา
- ตัดคอร์ส ดูคอร์สคงเหลือ และโอนคอร์สระหว่างลูกค้า
- ประวัติการใช้บริการ และยา/อุปกรณ์ที่ใช้ต่อครั้ง
สินค้า ยา & คลัง
สต๊อกหลายคลัง ล็อต วันหมดอายุ และงานจัดซื้อ
- ข้อมูลยา/สินค้า หน่วยนับ ราคา ชุดสินค้า วิธีใช้ ฉลากและสติกเกอร์ยา
- สต๊อกแยกคลัง ล็อต วันหมดอายุ บัตรคุมสต๊อก สรุปใกล้หมด/หมดอายุ
- ใบสั่งซื้อ รับเข้า เบิก โอนระหว่างสาขา ปรับปรุงสต๊อก
- ผู้ขาย/ซัพพลายเออร์ และส่งข้อมูลเข้า PEAK
ค่ามือ ค่าคอม & ผู้ใช้งาน
ส่งยอดค่าตอบแทนเข้าระบบเงินเดือนได้ตรง
- คำนวณค่ามือ/ค่าคอมต่อใบแจ้งหนี้ และดูยอดรายพนักงาน
- รายชื่อแพทย์/พนักงาน บทบาท ใบอนุญาต
- ตารางเวลาแพทย์และช่วงเวลาที่ว่าง
POST/handling/calculateGET/handling/gethandlingusersGET/user/calendar/user/{userId}ดูในเอกสาร29 endpointโปรโมชัน คูปอง & Gift Voucher
แคมเปญการตลาดที่ผูกกับการขายจริง
- ส่งโปรโมชันทาง SMS นับผู้รับก่อนส่ง และสรุปผลการส่ง
- คูปองส่วนลด แลกคูปอง และประวัติการแลก
- Gift Voucher — ออกเป็นล็อต ตรวจโค้ด คำนวณส่วนลด ใช้ข้ามสาขาได้
- บทความและรีวิวบนหน้าร้าน
POST/giftvoucher/validatePOST/coupon/useprocessPOST/promotion/recipient-previewดูในเอกสาร44 endpointรายงาน & Dashboard
ตัวเลขชุดเดียวกับหน้ารายงานในโปรแกรม ส่งต่อ BI ได้ทันที
- ยอดขาย กำไร รายรับ ลูกหนี้ ค่าใช้จ่าย ภาษี
- สต๊อก ความเคลื่อนไหว ยาควบคุม (วัตถุออกฤทธิ์ ประเภท 2–5 · ยาเสพติด ประเภท 3)
- คอร์ส/การใช้บริการ นัดหมาย คิว ลูกค้า และ RFM
- ตัวเลขหน้าแรก: ยอดขาย การชำระ กำไร ลูกค้าใหม่
ข้อมูลร้าน & ข้อมูลอ้างอิง
ค่าตั้งต้นที่ต้องใช้คู่กับทุกหมวด
- ข้อมูลร้าน/สาขาในเครือ และบัญชีรับเงิน
- ค่าสำหรับ dropdown: ห้อง เตียง แผนก บทบาท แพทย์ สิทธิ์การรักษา
- ไฟล์แนบ/อัปโหลด การแจ้งเตือน แพ็กเกจและ add-on
GET/reference/doctoruserGET/reference/righttreatmentPOST/notification/inbox/listดูในเอกสาร55 endpointดูครบทั้ง 950+ endpoint ในที่เดียว
พารามิเตอร์ ตัวอย่าง request/response ข้อความ error และปุ่มทดลองยิงในทุก endpoint
ตัวอย่างการนำไปใช้
รูปแบบการเชื่อมต่อที่พบบ่อย — เลือก endpoint จากหมวดด้านบนมาประกอบได้ตามงานของคุณ
ส่งเอกสารการเงินเข้า ERP/บัญชี
ดึงใบเสร็จ ใบกำกับภาษี ใบลดหนี้ และค่าใช้จ่ายประจำวันเข้าระบบบัญชีของคุณ ไม่ต้องคีย์ซ้ำ
POST/receipt/searchPOST/invoice/searchแอป/เว็บจองนัดของคลินิกเอง
ให้ลูกค้าดูช่วงเวลาว่างของแพทย์ จองนัด และดูประวัตินัดหมายผ่านแอปของคลินิก
GET/user/calendar/user/{userId}POST/appointment/addData warehouse / BI
ดึงรายงานยอดขาย กำไร และ RFM ทุกสาขาเข้า Power BI, Looker Studio หรือ data warehouse ของเครือ
POST/report/salessummaryPOST/report/rfmanalysisเครื่องแล็บ / LIS
ส่งผลตรวจจากเครื่องหรือระบบแล็บกลับเข้าคิวของคนไข้โดยตรง แพทย์เห็นผลทันที
PUT/lab/check/valuePOST/lab/searchตรวจสุขภาพองค์กร
นำเข้ารายชื่อพนักงานของบริษัทคู่สัญญา แล้วสร้างแฟ้มตรวจสุขภาพทั้งล็อตตามช่วงวันที่
POST/healthreport/company/{id}/employees/importPOST/healthreport/batchซิงค์ลูกค้ากับ CRM
รับ Webhook ทุกครั้งที่มีลูกค้าใหม่หรือแก้ไขข้อมูล แล้วอัปเดต CRM หรือระบบการตลาดอัตโนมัติ
POST/customer/paginationPOST/promotion/recipient-preview
สำหรับนักพัฒนา
เริ่มใช้งานใน 4 ขั้น
- 1เปิดใช้ add-on APIติดต่อทีมงาน APSX เพื่อเปิด add-on API ให้ร้านหรือเครือของคุณ
- 2คัดลอกคีย์เจ้าของร้านเข้า APSX › ตั้งค่าร้าน › เชื่อมต่อระบบ (API) › APSTH Shop API จะเห็น Public key และ Private key
- 3ขอ access tokenPOST /auth/oauth พร้อมคีย์ทั้งคู่ ได้ access_token ที่ผูกกับร้านของคุณ
- 4เรียก endpoint ที่ต้องการแนบ Authorization: Bearer <access_token> ทุกครั้ง แล้วตรวจ status ในผลลัพธ์
เก็บ Private key ไว้ฝั่ง server เท่านั้น — ห้ามใส่ในแอปมือถือหรือหน้าเว็บที่ผู้ใช้เปิดได้
# 1) ขอ access token (ใช้ซ้ำได้จนหมดอายุ)
curl -X POST https://shopv2.api-apsx.com/auth/oauth \
-H "Authorization: Bearer <PUBLIC_KEY>" \
-H "Content-Type: application/json" \
-d '{
"public_key": "<PUBLIC_KEY>",
"private_key": "<PRIVATE_KEY>"
}'
# → { "status": true, "message": "",
# "data": { "access_token": "eyJhbGciOi…" } }
# 2) ภาพรวมคลินิกตอนนี้ — ห้อง เตียง คิว แพทย์เข้าเวร
curl https://shopv2.api-apsx.com/floor/live \
-H "Authorization: Bearer <ACCESS_TOKEN>"
ข้อตกลงที่ควรรู้ก่อนเขียนโค้ด
ทุก endpoint ใช้รูปแบบเดียวกัน เขียนตัวเรียกครั้งเดียวใช้ได้ทั้งระบบ
// ✓ OK
{
"status": true,
"message": "",
"data": { … }
}
// ✗ business error — HTTP 200
{
"status": false,
"message": "Invalid or expire token.",
"data": ""
}
error ระดับ business (เช่น ยอดไม่พอ ข้อมูลซ้ำ) ตอบ HTTP 200 พร้อม status: false และเหตุผลใน message — ตรวจ status ทุกครั้ง อย่าดูแค่ HTTP code
- ร้าน/สาขา
- ล็อกจาก access token — เข้าถึงได้เฉพาะร้านที่คีย์นั้นมีสิทธิ์
- วันที่/เวลา
- YYYY-MM-DD และ YYYY-MM-DD HH:MM:SS เวลาไทย (UTC+7)
- จำนวนเงิน
- ตัวเลขทศนิยม 2 ตำแหน่ง หน่วยบาท
- รายการแบบแบ่งหน้า
- endpoint …/search และ …/pagination รับเลขหน้าและ per_page ใน body
- token หมดอายุ
- ได้ status: false + "Invalid or expire token." → ขอ token ใหม่ด้วย /auth/oauth
- จำกัดอัตรา
- /auth/oauth 20 ครั้ง/นาที/IP · /report/* 30 ครั้ง/นาที ต่อ token — เกินได้ HTTP 429
Webhook
รู้ทันทีเมื่อข้อมูลเปลี่ยน ไม่ต้องยิงถามซ้ำ
ตั้งปลายทางได้เองที่ APSX › ตั้งค่าร้าน › เชื่อมต่อระบบ (API) › Webhook (สูงสุด 10 ปลายทางต่อร้าน · https เท่านั้น)
customer.createdcustomer.updatedcourse.createdcourse.updatedcourse.deleted- ส่งเป็น POST JSON พร้อม header X-Apsx-Event · X-Apsx-Delivery · X-Apsx-Shop
- ตั้ง secret แล้วได้ลายเซ็น X-Apsx-Signature (HMAC-SHA256) ไว้ยืนยันว่ามาจาก APSX จริง
- ปลายทางล่มไม่เป็นไร — ส่งซ้ำอัตโนมัติ 1 นาที → 5 นาที → 30 นาที → 2 ชม. → 6 ชม.
- ดูประวัติการส่งและกดทดสอบได้จากหน้าตั้งค่า
POST https://your-app.example.com/apsx-webhook
X-Apsx-Event: customer.updated
X-Apsx-Delivery: 98231
X-Apsx-Shop: 123
X-Apsx-Signature: sha256=5f1c…
{
"id": 98231,
"event": "customer.updated",
"shop_id": 123,
"ref_type": "customer",
"ref_id": 45678,
"occurred_at": "2026-11-08T10:15:00+07:00",
"attempt": 1,
"data": {
"id": 45678,
"ctm_id": "HN000123",
"first_name": "…",
"phone": "…"
}
}ปลอดภัยตั้งแต่การออกแบบ
ข้อมูลสุขภาพเป็นข้อมูลอ่อนไหว API จึงคุมสิทธิ์เข้มเท่ากับหน้าโปรแกรม
คีย์คู่ Public / Private
ออกให้ต่อร้าน ใช้ได้เฉพาะร้านที่เปิด add-on API อยู่
token ผูกกับร้าน
ร้านมาจาก access token ไม่ใช่จากค่าที่ส่งมา — เข้าถึงได้เฉพาะร้านที่คีย์นั้นมีสิทธิ์
เพิกถอนได้ทันที
เจ้าของร้านเปลี่ยนรหัสผ่าน token เดิมทั้งหมดใช้ไม่ได้ทันที
จำกัดอัตราการเรียก
กันการเดารหัสและการดึงรายงานหนัก ๆ ถี่เกินไป
HTTPS ทุกเส้น
รับเฉพาะการเชื่อมต่อที่เข้ารหัส ทั้ง API และ Webhook
มีบันทึกการใช้งาน
บันทึกการขอ token พร้อม IP ของผู้เรียก ตรวจย้อนหลังได้
ไม่อยากเขียนโค้ด? ถาม Claude ได้เลย
APSX เป็น MCP server ให้ Claude ดึงยอดขาย ค่ามือ นัดหมาย และยอดค้างจ่ายของร้านมาตอบเป็นภาษาคน ล็อกอินด้วยบัญชีโปรแกรมผ่าน OAuth — อ่านอย่างเดียว ไม่ต้องใช้คีย์ API
คำถามที่พบบ่อย
พร้อมเชื่อมระบบของคุณกับ APSX แล้วหรือยัง
เปิดเอกสารเพื่อดูทุก endpoint หรือคุยกับทีมงานเพื่อเปิดใช้ add-on API ให้ร้านของคุณ