คู่มือส่งภาพเข้า MOPH Imaging Hub

สเปก API ล่าสุดสำหรับส่ง DICOM/PNG เข้าคลังภาพหมอพร้อม

ตั้งค่า Admin

1. Endpoints

  • UAT: https://uat-imh.inet.co.th/ct/v1/import/dicom
  • PRD: https://imh.moph.go.th/ct/v1/import/dicom
  • Method: POST, multipart/form-data

2. Headers (บังคับ)

  • Authorization: Bearer <Provider Access token>
  • client-id และ secret-key ของ Provider ID
  • hospital-code และ X-Hospital-Code รหัส 5 หลัก เช่น 11181

ถ้าไม่ใส่ client-id/secret-key อาจเจอ 401 หรือ 500 จาก API Gateway

3. Query + Form Data

Query: ?provider_hcode=11181 (ใส่ใน URL เท่านั้น ห้ามซ้ำใน form)

Form fields:

  • files — ไฟล์ .dcm หรือ .png
  • type — xray, ct_scan, mammogram, ophthalmic_photo
  • scan_type — chest, brain, abdomen ฯลฯ
  • dimension — 2D หรือ 3D
  • file_type — dcm หรือ png
  • cid — เลขบัตรประชาชน 13 หลัก (บังคับ)
  • is_emergency — "true" หรือ "false"

4. วิธีใช้ใน SCPACS

  1. Admin → เปิด MOPH Imaging Hub
  2. เลือก Environment (UAT/PRD) และตรวจ API URL
  3. Login Provider ID หรือใส่ Provider Token
  4. ตั้ง Provider HCODE = 11181 และ Default CID (13 หลัก)
  5. ส่งภาพได้ 3 ทาง:
    • FTP Import — ส่งอัตโนมัติเมื่อรับไฟล์
    • หน้าแรก — เลือก Study แล้วกด ส่งเข้า MOPH Imaging Hub
    • ทดสอบ CLI — python test_moph_upload.py path\to\file.dcm

5. Response สำเร็จ

{
  "message": "success",
  "message_th": "สำเร็จ",
  "status": 200,
  "transaction_uid": "..."
}