Spaces:

Medagen
/

Backend

Sleeping

Backend / API_INTEGRATION.md

Cuong2004

Add API Integration Guide for Triage Health Check endpoint with detailed request and response specifications. Update agent executor to enforce concise and clear response formatting guidelines in Vietnamese, ensuring compliance with medical guidelines and improving user interaction clarity.

1935826 2 months ago

preview code

raw

history blame contribute delete

1.7 kB

API Integration Guide

Endpoint: Triage Health Check

URL: POST /api/health-check
Base URL: https://medagen-backend.hf.space (hoặc URL của bạn)

Request

{
  "user_id": "string (required)",
  "text": "string (optional, required if no image_url)",
  "image_url": "string (optional, required if no text)",
  "session_id": "string (optional)",
  "location": {
    "lat": "number (optional)",
    "lng": "number (optional)"
  }
}

Response

{
  "triage_level": "emergency|urgent|routine|self-care",
  "symptom_summary": "string",
  "red_flags": ["string"],
  "suspected_conditions": [
    {
      "name": "string",
      "source": "cv_model|guideline|user_report",
      "confidence": "low|medium|high"
    }
  ],
  "cv_findings": {
    "model_used": "derm_cv|eye_cv|wound_cv|none",
    "raw_output": {}
  },
  "recommendation": {
    "action": "string",
    "timeframe": "string",
    "home_care_advice": "string",
    "warning_signs": "string"
  },
  "message": "string (markdown response)",
  "session_id": "string",
  "nearest_clinic": {
    "name": "string",
    "distance_km": "number",
    "address": "string",
    "rating": "number"
  }
}

Example

curl -X POST https://medagen-backend.hf.space/api/health-check \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "user123",
    "text": "đau mũi, có mụt nhọt",
    "image_url": "https://example.com/image.jpg"
  }'

Notes

text hoặc image_url phải có ít nhất một
session_id tự động tạo nếu không có
Response message chứa markdown tự nhiên từ LLM
triage_level xác định mức độ khẩn cấp