File size: 1,720 Bytes
a763afd |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 |
# 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
|