開始使用
快速開始
選擇所需接口、設定測試環境、交付欄位與範例。
1. 按需求選擇接口#
| 需要做什麼 | 院方提供 | 參考 |
|---|---|---|
| 查詢資料 | 清單／搜尋及單筆讀取；篩選條件與識別碼 | 查詢資料 |
| 新增紀錄 | 新增接口；欄位驗證與可查回的紀錄 ID | 新增範例 |
| 修改紀錄 | 可修改欄位、更新接口及版本衝突處理 | 修改範例 |
| 刪除或作廢 | 支援方式、狀態限制及結果查詢 | 作廢範例 |
| 附上或查看檔案 | 上傳、關聯及授權下載接口 | 照片與附件 |
只提供所需操作，不要求每個資源都有完整 CRUD。已有接口可直接交付文件；缺少的操作再新增。格式不同時附現有規格，由 Poieti 評估適配。
2. 接通測試環境#
以下 cURL 用來驗證院方提供的接口，不是呼叫 Poieti。將網址、憑證與測試 ID 換成院方資料。Bearer token 為範例，實際依院方認證方式設定。
設定環境變數 · 請替換範例網址
export HIS_BASE_URL="https://his.example.org/integration/v1"
export HIS_TOKEN="<院方測試憑證>"查詢病人 · cURL
curl "$HIS_BASE_URL/patients/P-DEMO-001" \
-H "Authorization: Bearer $HIS_TOKEN"200 OK
{
"patientId": "P-DEMO-001",
"medicalRecordNumber": "DEMO-001",
"displayName": "測試病人"
}預期結果：回傳指定病人；無權限時回 403。
3. 提供欄位對照#
院方提供欄位用途、型別、必填條件及單位；Poieti 填寫對應與轉換方式。下表的對應名稱也只是範例。
| 院方欄位（示例） | 意義 | 對應 |
|---|---|---|
pat_no | 穩定病人 ID | patientId |
visit_no | 本次就醫 ID | encounterId |
length_mm | 長度，毫米 | assessment.length.value，除以 10 轉 cm |
4. 加入寫入並驗收#
提供寫入請求、成功回執與錯誤範例。測試新增後可查回相同內容，重送不會重複建立紀錄。