您现在的位置是:首页 > 文章详情

Torna 1.26.0 发布,接口文档解决方案

日期:2024-01-23点击:73

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

  • 【新增】支持对接MeterSphere,将文档推送到MeterSphere中。需要在管理后台开启
  • 【新增】推送文档后创建一个默认的mock请求
  • 【修复】Nginx反向代理不支持basic auth #I8QA6G
  • 【修复】修复请求接口后响应信息太长时出现双滚动条 pr
  • 【优化】文档显示,描述列中使用字典类型,显示过窄,未能自适应 #I8Q0F3
  • 【优化】请求脚本新增sys.send,用来手动调用

关于 Torna

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

Torna 弥补了传统文档生成工具(如 swagger)的不如之处,在保持原有功能的前提下丰富并增强了一些实用的功能。

 

解决文档管理痛点

  • 不满足 swagger 文档预览页面和调试页面的展现方式
  • 不喜欢 swagger 这种侵入式注解
  • 希望使用 javadoc 注释生成文档,并进行接口调试
  • 希望把公司所有项目接口文档进行统一管理
  • 希望把项目中的若干文档提供给第三方调用者查看
  • 希望可以统一管理项目中的字典枚举

如果您有以上几个需求和痛点,或许可以尝试一下使用 Torna

快速开始

推荐组合

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

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

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

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

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

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

快速开始→

原文链接:https://www.oschina.net/news/276391/torna-1-26-0-released
关注公众号

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。

持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。

转载内容版权归作者及来源网站所有,本站原创内容转载请注明来源。

文章评论

共有0条评论来说两句吧...

文章二维码

扫描即可查看该文章

点击排行

推荐阅读

最新文章