Torna 1.8.0 发布,支持接口聚合,提供 Swagger 插件

来源: 投稿
2021-05-27

Torna 1.8.0 发布,本次发布内容如下:

  • 【特性】新增聚合空间,可聚合其它空间中的文档统一展示
  • 【增强】新增swagger插件,自动将本地文档推送到Torna服务器  doc
  • 【增强】推送接口支持排序字段

聚合空间的使用场景:企业需要提供若干个文档给第三方查看,但是这些文档可能不在一个系统当中,甚至不在一个开发团队当中,现在需要把这些文档聚合进来,统一展示。

本次发布新增了一个swagger插件,插件的作用是将本地项目中的Swagger文档内容推送到Torna服务器。SpringBoot项目只需要依赖一个starter,指定完配置文件就能把项目中的swagger文档推送到Torna服务器,然后可以在Torna页面中进行浏览、调试。

关于Torna

企业接口文档解决方案,目标是让文档管理变得更加方便、快捷。Torna采用团队协作的方式管理和维护项目API文档,将不同形式的文档纳入进来,形成一个统一的维护方式。

特性介绍

  • 支持接口文档增删改查
  • 支持导入外部接口(支持导入swagger、postman)
  • 支持分享文档(匿名访问、密码访问)
  • 支持OpenAPI管理接口
  • 支持字典管理
  • 支持导出为markdown格式、html格式
  • 支持文档聚合,将不同模块中的文档聚合展示
  • 支持多环境接口调试
  • 支持Mock数据
  • 支持文档权限管理,访客、开发者、管理员对应不同权限
  • 支持第三方登录接入/OAuth认证登录
  • 支持钉钉免密登录
  • 支持设置全局请求头/请求参数/响应参数
  • 支持中英文切换(i18n)
  • 支持docker运行
  • 提供swagger插件,快速导入swagger文档
  • 提供`管理模式`和`浏览模式`双模式,管理模式用来编辑文档内容,浏览模式纯粹查阅文档,界面无其它元素干扰
  • 部署简单,直接运行脚本启动程序

推荐组合

smart-doc + Torna实现文档全流程自动化

如果您使用Java语言,推荐使用smart-doc + Torna

smart-doc + Torna 组成行业领先的文档生成和管理解决方案,使用smart-doc无侵入完成Java源代码和注释提取生成API文档,自动将文档推送到Torna企业级接口文档管理平台。

通过这套组合您可以实现:只需要写完Java注释就能把接口信息推送到Torna平台,从而实现接口预览、接口调试。

推送的内容有:接口名称/author/Path参数/Header/请求参数/返回参数/字典列表/公共错误码

如果您是非Java语言,可以使用表单页面编辑以上内容,完成后同样可以进行接口预览、调试。

展开阅读全文
11 收藏
分享
加载中
最新评论 (1)
更新频率太快了
2021-05-27 12:03
0
回复
举报
更多评论
0 评论
11 收藏
分享
返回顶部
顶部