API — Bắt đầu

Base URL: https://api.hoatieu3.com · OpenAPI 3.1: /openapi.json

Xác thực

Ai	Cách
Công khai	/v1/meta, /v1/navigate, /v1/hospitals*
Người bệnh / người nhà	Authorization: Bearer <accessToken> nhận khi tạo case
Bác sĩ được mời	token trong đường dẫn /v1/review/{token}
Hoa tiêu viên	Authorization: Bearer <NAVIGATOR_TOKEN>

Lỗi luôn có dạng { "error": "..." }.

Thử nhanh

curl -s https://api.hoatieu3.com/v1/navigate \
  -H 'content-type: application/json' \
  -d '{"need":"checkup","patient":{"age":62,"sex":"male","province":"Nghệ An"},
       "symptoms":"Điện tim bất thường, hay hồi hộp","preferredCity":"Hà Nội"}'

Kết quả rút gọn:

{
  "safety": { "emergency": false, "urgency": "routine", "reasons": [] },
  "specialties": ["cardiology"],
  "primary": {
    "hospital": { "id": "h-viettim", "name": "Viện Tim Hà Nội" },
    "department": { "name": "Khoa Khám bệnh – Tim mạch" },
    "reasons": ["Có Khoa Khám bệnh – Tim mạch", "Có dịch vụ chẩn đoán cần thiết (ECG, ECHO)", "Ở Hà Nội như bạn mong muốn"]
  },
  "nextSteps": [
    { "n": 1, "icon": "🏥", "title": "Đến Viện Tim Hà Nội" },
    { "n": 2, "icon": "🩺", "title": "Vào Khoa Khám bệnh – Tim mạch" },
    { "n": 3, "icon": "🕐", "title": "Có mặt trước 6:45" }
  ],
  "humanNavigator": { "recommended": false, "reasons": [] }
}

Danh sách endpoint

Method	Path	Mô tả
GET	/health	Tình trạng
GET	/v1/meta	Nhu cầu, dấu hiệu nguy hiểm
POST	/v1/navigate	Chạy engine, không lưu
POST	/v1/cases	Tạo Navigation Case
GET / PATCH	/v1/cases/{id}	Xem / cập nhật trạng thái
POST	/v1/cases/{id}/renavigate	Chạy lại engine
POST / DELETE	/v1/cases/{id}/contacts[/{cid}]	Contact Network
POST / GET	/v1/cases/{id}/documents	Tải lên / liệt kê ảnh & hồ sơ
GET / DELETE	/v1/cases/{id}/documents/{docId}[/file]	Xem / xóa file
POST / GET / DELETE	/v1/cases/{id}/shares[/{sid}]	Link cho bác sĩ
GET	/v1/review/{token}	Bác sĩ xem hồ sơ
GET	/v1/review/{token}/documents/{docId}/file	Bác sĩ xem file
POST	/v1/review/{token}/opinions	Bác sĩ ghi ý kiến
POST / PATCH	/v1/cases/{id}/followups[/{fid}]	Tái khám
GET	/v1/hospitals?city=&specialty=&q=	Tìm bệnh viện
GET	/v1/hospitals/{id}	Nút bệnh viện đầy đủ
GET	/v1/navigator/queue	Hàng đợi hoa tiêu viên