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

V2EX = way to explore

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

现在注册

已注册用户请登录

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

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

第 1 条附言 · 2018 年 2 月 18 日

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

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

TangMonk

2018 年 2 月 18 日 via Android

就直接 markdown 呗

Cbdy

2018 年 2 月 18 日 via Android

blueprint

derek80

2018 年 2 月 18 日 via Android

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

wintercoder

2018 年 2 月 18 日

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

whileFalse

2018 年 2 月 18 日

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

derek80

2018 年 2 月 18 日 via Android

我们用 vscode 直接写。

WilliamLin

2018 年 2 月 18 日 via Android

apizza，用起来简单点

funing

2019 年 8 月 29 日

apizza api 接口管理挺简单的

balabalaguguji

2019 年 12 月 3 日