5.4 接口契约:/v1/cds/suggestions
在定义好基础数据模型后,我们需要明确核心交互的 API 契约。这里以 /v1/cds/suggestions 为例,这是临床决策支持系统(CDSS)获取建议的关键入口。
请求 POST /v1/cds/suggestions
{
"patientId": "p123",
"chiefComplaint": "发热、咳嗽 3 天",
"vitalSigns": {
"temperature": 38.5,
"heartRate": 95
}
}
注意这里的 vitalSigns 结构,实际项目中通常会根据不同科室需求动态扩展。为了保持系统的健壮性,我们在 Go 端接收时建议使用 map[string]interface{} 或者自定义的泛型结构体来容纳这些可能变化的生命体征数据。
响应示例
{
"code": 200,
"data": [
{
"diagnosis": "上呼吸道感染",
"confidence": 0.92,
"recommendation": "建议进行血常规检查"
}
]


