直接答案:接口数据字典不能只有字段名和类型。每个字段至少要定义业务含义、来源系统、采集或发生时间、单位、值域、空值规则、更新方式、责任方和版本。对体重等重复采集数据,还必须区分测量时间、录入时间与接口同步时间。
减肥门诊常与HIS、电子病历、检查检验、体检、患者端和随访平台交换数据。如果双方只约定“weight”“status”这类字段名,很容易出现单位、时间和状态含义不一致的问题。
从业务问题反推字段定义
先明确字段服务于身份匹配、诊疗记录、患者自报、任务执行还是质量统计,再决定主数据来源。一个字段只能有清晰的业务定义;同名但含义不同的数据,应拆分并使用明确名称。

数值字段必须携带单位和测量语境
体重、身高、腰围等数值需要约定单位、精度、允许范围和测量条件。患者自报、家用设备上传和院内测量应标明来源,不能在接口进入后丢失来源标签。
至少区分三类时间
业务发生或测量时间说明数据何时产生,录入时间说明何时进入来源系统,同步时间说明何时被接口传输。质量统计和趋势分析通常不能只用同步时间。
值域与空值要可机器校验
状态、类型和来源等枚举字段应维护代码、显示名称、生效时间和停用时间。空值、未知、不适用和未采集不是同一含义,应在接口规范中分别约定。
版本变更先评估兼容性
新增可选字段、修改值域和改变既有字段含义的影响不同。发布新版本前,应列出上下游系统、映射规则、切换窗口和回退方案,并保留历史版本以解释旧数据。
常见问题
可以直接复制某个系统的数据库字段作为字典吗?
不建议。数据库结构不等于跨系统业务语义,应由业务和信息化团队共同确认。
患者端字段能否直接写入电子病历?
应标明数据来源并经过医院批准的确认流程,不能默认把患者自报数据等同于医务人员记录。
权威来源
参考国家卫生健康委《健康信息数据元标准化规则 WS/T 304—2023》及《电子病历系统功能规范(试行)》。具体接口应结合医院现有标准和主数据治理要求实施。