求推荐个简单的 API 接口文档设计工具， Swagger 太特么复杂了

V2EX = way to explore

V2EX 是一个关于分享和探索的地方

现在注册

已注册用户请登录

V2EX 提问指南

这是一个创建于 2457 天前的主题，其中的信息可能已经有所发展或是发生改变。

只要能用纯文本存储就好了。放 git 里面自己看的。

第 1 条附言 · 2018-02-18 12:48:26 +08:00

找到一个办法，用 paw 做可视化的设计，然后可以导出 swagger 格式的 json 文件。

9 条回复 • 2019-12-03 17:43:31 +08:00

TangMonk

2018-02-18 08:29:39 +08:00 via Android

就直接 markdown 呗

Cbdy

2018-02-18 08:49:39 +08:00 via Android

blueprint

derek80

2018-02-18 09:13:09 +08:00 via Android

swagger 还好啊，我们用 aws API gateway 可以直接导入，配合 terraform 好用的不要不要的。

wintercoder

2018-02-18 11:42:27 +08:00

apidoc 就在代码里写注释就好了

whileFalse

2018-02-18 12:47:24 +08:00

@TangMonk 一开始用 markdown，稍微多写点说明就感觉很乱。
@derek80 那你们怎么写呢？手写吗？
@wintercoder 是个办法，不过我想先写 API 文档，设计好了再写代码。

derek80

2018-02-18 13:32:04 +08:00 via Android

我们用 vscode 直接写。

WilliamLin

2018-02-18 18:51:11 +08:00 via Android

apizza，用起来简单点

funing

2019-08-29 11:41:23 +08:00

apizza api 接口管理挺简单的

balabalaguguji

2019-12-03 17:43:31 +08:00