HEALTH_CHECK_API.md

# Health Check API - Integration Guide

## Endpoint

```
POST /api/health-check
```

## Request Body

```json
{
  "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

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

## Response

```json
{
  "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