版本更新记录

本页用于记录开放平台文档、版本策略和接入规则的重要更新。

这里记录的是影响接入理解、版本判断和文档结构的关键节点，不逐条展开所有接口字段级微调。

当前状态

截至目前，开放平台的版本口径如下：

• 当前对外稳定开放版本：2.0
• 当前公开文档默认对应版本：2.0
• 后续新增实现与能力演进：进入 3.0

如需理解版本边界与兼容原则，建议同时阅读 版本与变更策略。

更新记录

2026 年 4 月 10 日

文档结构补充与目录重组

• 文档中心新增 开始接入、平台规则、解决方案、能力说明、常见问题、更新日志 等分组
• 顶层导航增加 接口能力 聚合层，用于收拢原有能力目录，减少首页一级目录数量
• 文档侧边栏改为直接读取当前 content/docs 内容源，开发环境支持热读取文档结构与内容

平台介绍与接入文档拆分

• 原 接口概述 调整为 平台介绍
• 接入基础说明拆分为 快速开始与接入、认证与调用约定、请求示例与调试
• 文档中心开始区分 平台介绍、接入准备、平台规则 与具体接口能力，降低首次阅读成本

新增规则与方案类页面

• 新增 平台规则总览、版本与变更策略、合规与使用边界
• 新增 药品对码标准化方案、智能导诊与问病方案、医院机构搜索与建档方案
• 新增 接入 FAQ 与错误排查，用于整理常见联调问题和错误码排查路径

文案与展示规范补充

• 文档文案开始统一收敛表达方式，减少口语化称谓。
• 方案类文档中的中文引号统一改为直角引号，减少展示风格不一致问题
• 平台介绍页补充了能力概览、适用场景、阅读路径和版本入口说明

2025 年 10 月 24 日

2.0 冻结

自 2025 年 10 月 24 日起，2.0 进入冻结维护状态，后续不再承接新的核心能力演进。

冻结后的维护范围主要包括：

• 文档勘误和表述修正
• 参数说明补充
• 示例优化
• 不改变既有语义的缺陷修复

原则上，以下内容不再直接进入 2.0：

• 新能力
• 新主流程
• 会改变字段语义或返回模型的调整
• 会影响旧客户端理解的行为变化

2025 年 10 月 24 日之后

3.0 作为后续演进版本线

在 2.0 冻结之后，后续新增实现与能力演进统一进入 3.0 规划。

这意味着：

• 现有 /doc/* 路径继续代表 2.0
• 2.0 继续服务已接入和正在接入的合作方
• 新的能力设计、字段结构调整和结果模型升级，默认归入 3.0

记录口径

后续新增记录时，建议按下面的口径维护：

1. 只记录影响接入判断、版本理解、文档结构或合作方使用方式的关键更新
2. 单纯错别字修正或细小文案润色，一般不单独记入版本记录
3. 若某次变更涉及版本边界调整，应明确写出日期、适用范围和影响对象

如需查看当前适用的接入规则，可继续阅读 平台规则总览。