ข้ามไปเนื้อหา

คู่มือการใช้งาน (API Integration)

คู่มือการใช้งาน (API Integration) ของโปรแกรม คลินิก APSX Platform รองรับธุรกิจประเภท Clinic, Spa, Wellness, Hospital, Beauty, ศูนย์ดูแลผู้สูงอายุ, คลินิกสุขภาพจิต, คลินิกตา, ทุกประเภทคลินิก

เชื่อมข้อมูลคลินิกกับระบบของคุณผ่าน REST API ตามมาตรฐาน OpenAPI 3.1 — อ่านและเขียนได้ทุกงานเดียวกับหน้าโปรแกรม ตั้งแต่ลูกค้า นัดหมาย คิว เวชระเบียน ไปจนถึงใบเสร็จ สต๊อก ค่ามือ และรายงาน

endpoint พร้อมใช้
950+endpoint พร้อมใช้
หมวดงาน
11หมวดงาน
เอกสารมาตรฐาน ทดลองยิงได้ในหน้าเอกสาร
OpenAPI 3.1เอกสารมาตรฐาน ทดลองยิงได้ในหน้าเอกสาร
แจ้งเตือนขาออกเมื่อข้อมูลเปลี่ยน
Webhookแจ้งเตือนขาออกเมื่อข้อมูลเปลี่ยน
เริ่มเรียกได้ใน 2 คำสั่งREST · JSON
# 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>" }'

# 2) เรียกใช้ API ด้วย token ที่ได้
curl https://shopv2.api-apsx.com/floor/live \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

ทุก response มี status · message · data — ตรวจ status ก่อนใช้ data เสมอ

ครอบคลุมทุกงานในคลินิก

ทำอะไรผ่าน API ได้บ้าง

ทุกงานที่ทำในหน้าโปรแกรม ทำผ่าน API ได้ทั้งอ่านและเขียน — แบ่งเป็น 11 หมวดธุรกิจ แต่ละหมวดมีตัวอย่าง endpoint และลิงก์ไปหน้าเอกสารที่มีพารามิเตอร์ ตัวอย่าง request/response ครบ

  • ลูกค้า & CRM

    ข้อมูลลูกค้าครบทุกมิติ ใช้ร่วมกันทุกสาขาในเครือ

    • สร้าง/แก้ไขลูกค้า ออก HN อัตโนมัติ ตรวจเลขบัตรประชาชนซ้ำทุกสาขา
    • ประวัติการรักษา นัดหมาย ผลตรวจ แพ้ยา สิทธิ์การรักษา และไฟล์แนบ
    • กลุ่มลูกค้า แท็ก วงเงิน (coin) และไปป์ไลน์การขาย
    • วิเคราะห์รายคน — ความถี่การมา แนวโน้มการใช้จ่าย ความเสี่ยงหาย
    POST/customerGET/customer/citizen/{citizenId}GET/customer/analytics/{customerId}
  • นัดหมาย & คิว

    ตั้งแต่จองนัดจนลูกค้าเดินออกจากคลินิก

    • สร้าง/ค้นหา/ยืนยัน/ยกเลิกนัด ดูตารางแพทย์และช่วงเวลาว่าง
    • เปิดคิว (เช็คอิน) เปลี่ยนสถานะ ยกเลิก และบันทึกเพิ่มเติมของคิว
    • สั่งยา ตรวจ Lab/X-Ray และตัดคอร์สลงในคิว
    • ภาพรวมคลินิกแบบสด — ห้อง เตียง คิววันนี้ แพทย์เข้าเวร
    POST/appointment/addPOST/queueGET/floor/live
  • เวชระเบียน & การรักษา

    OPD · IPD · ER · ผ่าตัด · แผนไทย · เทเลเมดิซีน

    • OPD ทั่วไป ทันตกรรม จักษุ กระดูกและข้อ และแบบฟอร์ม OPD ที่ร้านออกแบบเอง
    • ผู้ป่วยใน: Admit · Vital Signs · Nursing note · MAR · ย้ายเตียง · จำหน่าย
    • ห้องฉุกเฉิน ตารางผ่าตัด/วิสัญญี แพทย์แผนไทย เทเลเมดิซีน
    • รหัสวินิจฉัย ICD และใบรับรองแพทย์
    POST/ipd/admitGET/opdDental/customer/{customerId}POST/{shopId}/thai-med/consultations
  • ตรวจ แล็บ & ตรวจสุขภาพ

    เชื่อมเครื่องแล็บ/LIS และงานตรวจสุขภาพองค์กร

    • รายการตรวจ ชุดตรวจ และราคาตามสิทธิ์
    • บันทึกผลแล็บ/X-Ray กลับเข้าคิว พร้อมค่าอ้างอิงและรูปผลตรวจ
    • แฟ้มตรวจสุขภาพ — รวมผลจากคิวเป็นเล่ม ออกเลขที่ สร้างอัตโนมัติตามช่วงวันที่
    • บริษัท/นายจ้างและนำเข้ารายชื่อพนักงาน
    PUT/lab/check/valuePOST/healthreportPOST/healthreport/batch
  • ขาย · ใบแจ้งหนี้ · ใบเสร็จ

    เอกสารการเงินครบชุด พร้อมส่งต่อระบบบัญชี

    • รายการขาย ใส่ยา/คอร์ส/ตรวจ/วงเงิน และส่วนลด
    • ใบแจ้งหนี้ ใบเสร็จ ใบกำกับภาษี ใบลดหนี้ — ค้นหา พิมพ์ ยกเลิก
    • ขายด่วน: ออกรายการขาย + ใบแจ้งหนี้ในครั้งเดียว
    • ค่าใช้จ่ายของร้าน และส่งข้อมูลเข้า PEAK
    POST/order/express/orderandinvoicePOST/receipt/searchGET/taxinvoice/{id}
  • คอร์ส & การใช้บริการ

    ขายคอร์สเป็นครั้ง ตัดคอร์ส และติดตามคงเหลือ

    • ข้อมูลคอร์ส ชุดคอร์ส นำเข้า Excel และซิงค์จากร้านแม่ไปสาขา
    • ตัดคอร์ส ดูคอร์สคงเหลือ และโอนคอร์สระหว่างลูกค้า
    • ประวัติการใช้บริการ และยา/อุปกรณ์ที่ใช้ต่อครั้ง
    POST/service/processPOST/service/tranferGET/service/item/{serviceId}
  • สินค้า ยา & คลัง

    สต๊อกหลายคลัง ล็อต วันหมดอายุ และงานจัดซื้อ

    • ข้อมูลยา/สินค้า หน่วยนับ ราคา ชุดสินค้า วิธีใช้ ฉลากและสติกเกอร์ยา
    • สต๊อกแยกคลัง ล็อต วันหมดอายุ บัตรคุมสต๊อก สรุปใกล้หมด/หมดอายุ
    • ใบสั่งซื้อ รับเข้า เบิก โอนระหว่างสาขา ปรับปรุงสต๊อก
    • ผู้ขาย/ซัพพลายเออร์ และส่งข้อมูลเข้า PEAK
    POST/productstore/summaryPOST/productstore/stock-cardPOST/purchessorder
  • ค่ามือ ค่าคอม & ผู้ใช้งาน

    ส่งยอดค่าตอบแทนเข้าระบบเงินเดือนได้ตรง

    • คำนวณค่ามือ/ค่าคอมต่อใบแจ้งหนี้ และดูยอดรายพนักงาน
    • รายชื่อแพทย์/พนักงาน บทบาท ใบอนุญาต
    • ตารางเวลาแพทย์และช่วงเวลาที่ว่าง
    POST/handling/calculateGET/handling/gethandlingusersGET/user/calendar/user/{userId}
  • โปรโมชัน คูปอง & Gift Voucher

    แคมเปญการตลาดที่ผูกกับการขายจริง

    • ส่งโปรโมชันทาง SMS นับผู้รับก่อนส่ง และสรุปผลการส่ง
    • คูปองส่วนลด แลกคูปอง และประวัติการแลก
    • Gift Voucher — ออกเป็นล็อต ตรวจโค้ด คำนวณส่วนลด ใช้ข้ามสาขาได้
    • บทความและรีวิวบนหน้าร้าน
    POST/giftvoucher/validatePOST/coupon/useprocessPOST/promotion/recipient-preview
  • รายงาน & Dashboard

    ตัวเลขชุดเดียวกับหน้ารายงานในโปรแกรม ส่งต่อ BI ได้ทันที

    • ยอดขาย กำไร รายรับ ลูกหนี้ ค่าใช้จ่าย ภาษี
    • สต๊อก ความเคลื่อนไหว ยาควบคุม (วัตถุออกฤทธิ์ ประเภท 2–5 · ยาเสพติด ประเภท 3)
    • คอร์ส/การใช้บริการ นัดหมาย คิว ลูกค้า และ RFM
    • ตัวเลขหน้าแรก: ยอดขาย การชำระ กำไร ลูกค้าใหม่
    POST/report/salessummaryPOST/report/profitPOST/report/rfmanalysis
  • ข้อมูลร้าน & ข้อมูลอ้างอิง

    ค่าตั้งต้นที่ต้องใช้คู่กับทุกหมวด

    • ข้อมูลร้าน/สาขาในเครือ และบัญชีรับเงิน
    • ค่าสำหรับ dropdown: ห้อง เตียง แผนก บทบาท แพทย์ สิทธิ์การรักษา
    • ไฟล์แนบ/อัปโหลด การแจ้งเตือน แพ็กเกจและ add-on
    GET/reference/doctoruserGET/reference/righttreatmentPOST/notification/inbox/list
  • ดูครบทั้ง 950+ endpoint ในที่เดียว

    พารามิเตอร์ ตัวอย่าง request/response ข้อความ error และปุ่มทดลองยิงในทุก endpoint

ตัวอย่างการนำไปใช้

รูปแบบการเชื่อมต่อที่พบบ่อย — เลือก endpoint จากหมวดด้านบนมาประกอบได้ตามงานของคุณ

  • ส่งเอกสารการเงินเข้า ERP/บัญชี

    ดึงใบเสร็จ ใบกำกับภาษี ใบลดหนี้ และค่าใช้จ่ายประจำวันเข้าระบบบัญชีของคุณ ไม่ต้องคีย์ซ้ำ

    POST/receipt/searchPOST/invoice/search
  • แอป/เว็บจองนัดของคลินิกเอง

    ให้ลูกค้าดูช่วงเวลาว่างของแพทย์ จองนัด และดูประวัตินัดหมายผ่านแอปของคลินิก

    GET/user/calendar/user/{userId}POST/appointment/add
  • Data 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. 1เปิดใช้ add-on APIติดต่อทีมงาน APSX เพื่อเปิด add-on API ให้ร้านหรือเครือของคุณ
  2. 2คัดลอกคีย์เจ้าของร้านเข้า APSX › ตั้งค่าร้าน › เชื่อมต่อระบบ (API) › APSTH Shop API จะเห็น Public key และ Private key
  3. 3ขอ access tokenPOST /auth/oauth พร้อมคีย์ทั้งคู่ ได้ access_token ที่ผูกกับร้านของคุณ
  4. 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 ใช้รูปแบบเดียวกัน เขียนตัวเรียกครั้งเดียวใช้ได้ทั้งระบบ

ซอง response มาตรฐาน
// ✓ 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

ไม่อยากเขียนโค้ด? ถาม Claude ได้เลย

APSX เป็น MCP server ให้ Claude ดึงยอดขาย ค่ามือ นัดหมาย และยอดค้างจ่ายของร้านมาตอบเป็นภาษาคน ล็อกอินด้วยบัญชีโปรแกรมผ่าน OAuth — อ่านอย่างเดียว ไม่ต้องใช้คีย์ API

ดูวิธีเชื่อม Claude

คำถามที่พบบ่อย

พร้อมเชื่อมระบบของคุณกับ APSX แล้วหรือยัง

เปิดเอกสารเพื่อดูทุก endpoint หรือคุยกับทีมงานเพื่อเปิดใช้ add-on API ให้ร้านของคุณ

ใครใช้ API ได้บ้าง
ร้านหรือเครือที่เปิด add-on API ของ APSX — เจ้าของร้านจะเห็นคีย์ในหน้าตั้งค่าร้าน แล้วส่งให้ทีมพัฒนาหรือบริษัทที่รับเชื่อมระบบได้
มีค่าใช้จ่ายเท่าไหร่
API เป็น add-on แยกจากแพ็กเกจหลัก ติดต่อทีมงานเพื่อสอบถามราคาและเงื่อนไขสำหรับร้านของคุณ
ใช้คีย์ชุดเดิมจาก Shop API รุ่นแรกได้ไหม
ได้ — Shop API v2 ใช้คีย์ชุดเดียวกันและขั้นตอนขอ token แบบเดิม เปลี่ยนแค่ URL เป็น https://shopv2.api-apsx.com
ทดลองเรียก API ได้ที่ไหน
ในหน้าเอกสาร กดปุ่ม Test Request ของแต่ละ endpoint แล้วใส่ access token ได้เลย — คำสั่งทำกับข้อมูลจริงของร้าน ควรทดสอบคำสั่งที่เขียนข้อมูลอย่างระมัดระวัง
ข้อมูลหลายสาขาดึงรวมกันได้ไหม
คีย์ออกให้ต่อร้าน/สาขา token จะเห็นเฉพาะร้านของคีย์นั้น บาง endpoint (เช่น ค้นหาลูกค้า) ค้นได้ทั้งเครือ — ระบุไว้ในเอกสารของแต่ละเส้น
ถ้าเรียกแล้วได้ status: false ทำอย่างไร
อ่านเหตุผลใน message — แต่ละ endpoint ในเอกสารมีรายการข้อความที่เป็นไปได้ไว้ให้แล้ว ถ้ายังไม่ชัดส่ง endpoint, body และ message มาที่ทีมงานได้