构建 AI 临床副驾驶：基于 Go 的电子病历智能助手与 HIS 对接实战（下）

5.4 接口契约：/v1/cds/suggestions

接下来我们定义核心交互接口，这是连接前端业务与后端 AI 能力的桥梁。

请求 POST /v1/cds/suggestions

接口需要接收患者的基础信息与当前症状描述。为了便于 Go 服务解析，我们采用标准的 JSON 格式。一个典型的请求体如下：

{
  "patientId": "p123",
  "chiefComplaint": "发热、咳嗽 3 天",
  "vitalSigns": {
    "temperature": 38.5,
    "heartRate": 90
  }
}

在 Go 端，我们需要定义对应的结构体来反序列化这些数据。这里要注意字段标签的映射，确保 JSON Key 与数据库或业务逻辑中的命名一致。

type SuggestionRequest struct {
	PatientID       string          `json:"patientId"`
	ChiefComplaint  string          `json:"chiefComplaint"`
	VitalSigns      VitalSignData   `json:"vitalSigns"`
}

type VitalSignData struct {
	Temperature float64 `json:"temperature"`
	HeartRate   int     `json:"heartRate"`
}

这样设计的好处是类型安全。当请求进来时，Go 会自动校验字段类型，避免因为前端传参错误导致服务崩溃。实际开发中，建议在这里加入校验逻辑，比如体温不能为负数等，保证进入 AI 模型的数据质量。