HEALTH_CHECK_API.md

Health Check API - Integration Guide

Endpoint

POST /api/health-check

Request Body

{
  "text": "tôi bị đau mũi, có nổi mụt nhọt",
  "image_url": "https://example.com/image.jpg",
  "user_id": "user123",
  "session_id": "optional-session-id",
  "location": {
    "lat": 10.762622,
    "lng": 106.660172
  }
}

Parameters

Field	Type	Required	Description
text	string	No*	Mô tả triệu chứng (bắt buộc nếu không có image_url)
image_url	string	No*	URL hình ảnh (bắt buộc nếu không có text)
user_id	string	Yes	ID của người dùng
session_id	string	No	Session ID để theo dõi lịch sử hội thoại
location	object	No	Vị trí của người dùng (lat, lng) - Cần thiết để tìm bệnh viện

Location Object

{
  "lat": 10.762622,  // Vĩ độ (latitude)
  "lng": 106.660172   // Kinh độ (longitude)
}

Response

{
  "triage_level": "routine",
  "symptom_summary": "tôi bị đau mũi, có nổi mụt nhọt",
  "suspected_conditions": [...],
  "recommendation": {...},
  "nearest_clinic": {
    "name": "Bệnh viện Da Liễu Trung ương",
    "distance_km": 2.5,
    "address": "123 Đường ABC, Quận XYZ",
    "rating": 4.5
  },
  "message": "..."
}

Lưu ý

• Location là tùy chọn nhưng cần thiết để tìm bệnh viện gần nhất
• Khi user hỏi "tôi nên đi khám ở đâu" hoặc triage level là emergency/urgent, cần có location để gọi MCP hospital tool
• Location được truyền trực tiếp vào MCP hospital tool khi cần