Torna 1.35.6 & 2.1.20 发布,接口文档解决方案

torna 1.35.6 与 2.1.20 版本正式发布,本次更新主要包含以下改进:

  • 单值返回结果展示逻辑优化,提升可读性
  • 修复接口名称为空时对应 Tab 标签意外消失的问题
  • 新增点击接口名称直接跳转至预览页面功能
  • 改进文档描述中 Markdown 格式识别与渲染逻辑

关于 Torna

Torna 是一款专注于接口文档管理的解决方案,致力于为团队提供更高效、更灵活的文档协作体验。它支持多成员协同编辑与维护接口文档,并兼容多种文档来源,实现统一归档与集中管控。

相较于传统工具(如 Swagger),Torna 在保留其核心能力的基础上,进一步拓展了实用性功能,有效弥补了原生方案在易用性、扩展性及集成性方面的不足。

直击文档管理核心痛点

  • 对 Swagger 提供的文档预览与调试界面不满意
  • 抵触侵入式注解方式(如 @Api@ApiOperation 等)
  • 倾向于基于标准 Javadoc 注释自动生成文档并支持在线调试
  • 需要将企业内多个项目的接口文档进行一体化管理
  • 希望对外部合作方开放指定项目文档的只读访问权限
  • 期望对项目中使用的字典、枚举等公共数据结构进行集中维护

若您正面临上述任一挑战,Torna 或许正是您需要的文档管理利器。

快速上手指南

推荐技术组合

smart-doc + Torna —— 构建全自动文档闭环体系

Java 开发者强烈推荐采用 smart-doc

+ Torna 组合方案。

该组合已成为行业公认的高效文档生成与管理实践:smart-doc 以零侵入方式解析 Java 源码与 Javadoc,精准提取 API 元信息,并自动同步至 Torna 企业级文档管理平台。

借助此方案,您仅需完成代码注释编写,即可实现接口文档的自动生成与实时推送,轻松完成文档预览、参数校验与在线调试全流程。

推送内容涵盖:接口标题 / 作者信息 / 路径参数 / 请求头 / 请求体参数 / 返回结构 / 字典映射表 / 公共错误码列表

对于非 Java 技术栈用户,亦可通过 Torna 内置的可视化表单编辑器手动录入以上全部字段,同样支持完整的预览与调试能力。

源码获取地址:立即下载