API接口文档 - 多组学AI健康管理系统

🧪 交互式API测试

Headers (JSON)

Request Body (JSON)

Response

点击"发送请求"开始测试...

🚀 快速开始

1. 获取Token

POST /auth/token
{
  "username": "admin",
  "password": "your_password"
}

2. 调用接口

Headers:
Authorization: Bearer {token}
Content-Type: application/json

3. 获取响应

{
  "status": "success",
  "data": {...}
}

📡

基础URL

http://localhost:8000

📚 接口分类

🔐 认证接口

POST /auth/token

获取访问令牌，用于后续API调用认证

请求示例

{
  "username": "admin",
  "password": "your_password"
}

响应示例

{
  "status": "success",
  "access_token": "eyJ...",
  "token_type": "bearer",
  "expires_in": 3600
}

POST /auth/verify

验证Token有效性

请求头

Authorization: Bearer {token}

响应示例

{
  "status": "success",
  "valid": true,
  "user_id": "user_001"
}

⚙️ 系统接口

GET /api/v1/system/status

获取系统运行状态和安全配置

响应示例

{
  "status": "online",
  "version": "v2.4.0-minimax",
  "security": {
    "rate_limiting": true,
    "rate_limit_requests": 100,
    "rate_limit_window": 60,
    "jwt_enabled": true,
    "security_headers": true
  },
  "endpoints": {
    "auth": "/auth/token",
    "verify": "/auth/verify",
    "docs": "/docs"
  }
}

🧬 组学分析接口

POST /api/v1/16s/upload 16S rRNA

上传FASTQ文件进行16S rRNA肠道菌群分析

参数

参数	类型	说明
file	file	FASTQ文件
sample_id	string	样本ID

响应示例

{
  "status": "success",
  "health_score": 78,
  "enterotype": "B肠型",
  "key_findings": [
    "双歧杆菌属丰度正常",
    "粪杆菌属略低"
  ]
}

POST /api/v1/genomics/upload 基因组

上传基因检测报告进行AI解读

参数

参数	类型	说明
file	file	PDF/图片文件
patient_id	string	患者ID

响应示例

{
  "status": "success",
  "interpretation": "...",
  "key_findings": [...],
  "risk_assessment": "低风险"
}

POST /api/v1/metabolomics/upload 代谢组

上传代谢组检测报告进行AI解读

参数

参数	类型	说明
file	file	PDF/图片文件

响应示例

{
  "status": "success",
  "interpretation": "...",
  "key_findings": [...],
  "metabolic_score": 72
}

🔗 多组学整合接口

POST /api/v1/multi-omics/integrate 核心接口

跨组学整合分析，发现不同组学间的关联关系

请求参数

参数	类型	说明
patient_id	string	患者ID
health_profile	JSON	健康档案
results_json	JSON	解读结果

响应示例

{
  "status": "success",
  "integrated_summary": "...",
  "risk_scores": {
    "cardiovascular": "中",
    "metabolic": "高",
    "immune": "低",
    "digestive": "低"
  },
  "priority_health_concerns": [...],
  "integrated_recommendations": [...]
}

POST /api/v1/multi-omics/generate-plan

基于整合分析结果生成个性化健康管理方案

目标周期选项

• 1个月 - 短期调整
• 3个月 - 标准方案 (默认)
• 6个月 - 中期规划
• 1年 - 长期管理

响应包含

• 营养计划 (饮食建议、推荐食物)
• 运动计划 (频率、强度、时长)
• 睡眠计划 (目标时长、建议)
• 监测计划 (日常追踪指标)

POST /api/v1/multi-omics/export-pdf

导出完整的PDF综合报告

📄 返回PDF文件下载

⚠️ 错误码说明

错误码	说明
`400`	请求参数错误
`401`	未授权 / Token无效
`403`	权限不足
`404`	资源不存在
`413`	文件过大
`415`	不支持的文件类型
`429`	请求过于频繁
`500`	服务器内部错误

⏱️ 限流规则

🔐

认证接口

10次/分钟

📤

文件上传

20次/分钟

🔬

分析接口

30次/分钟