接口首页 近期更新 多维图书馆 API v3.0 发布

多维图书馆 API v3.0 发布

多维图书馆对外开放接口完成重大版本升级,引入跨维度文献联合检索、实时同步订阅与结构化引用导出功能,v2.x 接口将于2027年第一季度停止维护。

多维图书馆于2026年1月31日正式发布 MDLIB-API v3.0,这是自 v2.0 发布以来规模最大的一次接口重构。v3.0 在保留核心文献检索功能的基础上,新增了跨维度联合检索引擎、实时文献更新订阅流(WebSocket 协议)以及结构化引用数据导出(支持 XDCITE 格式),并对底层认证机制进行了全面对齐,完整支持 XDPS v4.x 身份令牌规范。

本次 API 升级的契机来源于多个合作机构的长期反馈。维度医疗中心在接入多维图书馆的医学文献数据库时,频繁遇到跨维度文献版本不一致的问题;世界观影院的内容团队也表达了对实时文献更新推送的需求。v3.0 的设计直接回应了上述场景。

迁移时间线:v2.x 接口将维持运行至2027年3月31日,届时正式下线。建议所有接入方在2026年第三季度前完成迁移评估,并于第四季度完成切换。多维图书馆技术团队将提供专项迁移支持,申请方式见本文末尾。

v3.0 新增功能

  • NEW 跨维度联合检索:单次查询可同步检索已开放数据共享协议的多个维度文献节点,结果集自动去重并标注来源维度编号。
  • NEW 实时订阅流:基于 WebSocket 的文献更新推送,支持按主题标签、维度编号或作者实体 ID 订阅,推送延迟通常低于 500ms(标准维度时间)。
  • NEW XDCITE 引用导出:支持将检索结果导出为跨维度标准引用格式(XDCITE v1.2),兼容学院系统的论文管理平台直接导入。
  • NEW 机密档案分级接口:新增针对限制级文献的专属接口端点,需提供 XIMA 颁发的高级访问凭证方可调用。
  • 改进 全面对齐 XDPS v4.x 认证规范,令牌刷新逻辑重构,会话保持时间延长至 72 小时(标准维度时间)。
  • DEP v2.x 全部端点将于2027年3月31日停止服务,包括 /search/legacy、/doc/v2/* 及旧式批量下载接口。

v2.x 至 v3.0 迁移要点

v3.0 对 API 基础路径和认证头格式进行了调整,不能直接替换版本号进行兼容调用。主要迁移变更包括:基础路径由 /api/v2/ 变更为 /api/v3/;认证头由 X-MDLIB-Token 统一变更为 Authorization: XDPS <token>;文献检索响应体结构有所调整,新增 source_dimension 字段。

多维图书馆技术团队提供专项迁移支持服务,接入方可通过 XIMA 工单系统申请一对一迁移协助,或参阅多维图书馆开发者文档中心(需凭有效接入凭证访问)中提供的自助迁移指南。

晶化空间存储节点扩容

配合 API v3.0 发布,多维图书馆在晶化空间(WD-010-ξ)的核心数据存储节点完成了第二期扩容,总存储容量提升 40%。跨维度联合检索功能的索引层即部署于该节点,晶格结构的高信息密度特性使得全文检索响应时间相较主位面节点缩短约 35%。