Swagger URL 插件上线,同步文档很简单

本次版本更新主要围绕这几个方面:

  • 从 Swagger URL 同步 API

  • API 编辑页面自动调整编辑器高度

  • Windows 安装包自定义 UI

但我最想说的还是这个 【从Swagger URL 同步 API】 的部分,也是本次更新的重点。

对于中小型(特别是 Java 技术栈)的开发团队来说,Swagger 是一个便捷的选择,好处是:

  • 代码即文档,编写成本低,不存在同步不及时的问题;

  • 生态好,各大 API 平台都支持基于 OpenAPI 格式的拓展。

但使用 Swagger 的用户有以下几个痛点:

  • 测试不方便,有简单的调用测试,但是没有历史也没有鉴权等功能;

  • 没有人员管理,无法协作/通知/版本管理;

  • 对于前端人员不友好,没有参数描述/值可能性,没有 Mock ;

  • 对代码有侵入性。

我们不追求让大家强制切换工具,而是作为代码的下游 API 文档工具,解决痛点的同时融合 Swagger 生态。

Postcat 通过以下两种方式支持代码生成文档:

  1. 如果你之前使用 Swagger,我们支持从 Swagger Url 自动同步 Swagger 数据;

    • 0
      点赞
    • 0
      收藏
      觉得还不错? 一键收藏
    • 0
      评论
    评论
    添加红包

    请填写红包祝福语或标题

    红包个数最小为10个

    红包金额最低5元

    当前余额3.43前往充值 >
    需支付:10.00
    成就一亿技术人!
    领取后你会自动成为博主和红包主的粉丝 规则
    hope_wisdom
    发出的红包
    实付
    使用余额支付
    点击重新获取
    扫码支付
    钱包余额 0

    抵扣说明:

    1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
    2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

    余额充值