请问大家有没有好用的 json 或者 api 文档管理工具

[unt]

需求：

1. 一定要清晰，清晰，清晰。每个字段的含义可以写详细注释，json 结构不要以表格的形式展示，要以 json 文档的形式展示；
2. 是“文档”管理，不是调试，不需要接口调试的功能；
3. 方便信息共享，最好是像 rap2 那样支持自部署的 web 端，或者客户端工具也可以；

[xuanbg]

手写，其实一点都不麻烦。也就是模版填空加上复制 /粘贴 /修改一点点内容。

[needpp]

查看右边的广告？

[wu67]

我觉得 gitlab 的 wiki 就很好, 直接用 markdown 写, object 型数据你爱怎么写都行, 复杂数据结构还能在下面写连接跳转对应结构的 wiki, 还有历史记录

[unt]

@xuanbg #1 主要是不美观，查看起来也不是很方便

[unt]

@wu67 #3 我去看看

[xuanbg]

@wu67 咱们想的完全一样。手写 markdown 才是程序员该干的事。

[inrmsYu]

apipost ？

[iamacodertoo]

yapi?

[unt]

@iamacodertoo #8 用过的，不行，文档功能不太好

@xuanbg #6 md 的话注释功能不行吧，我要给每个字段写注释，然后需要能够复制整个 json, 能实现吗

[balabalaguguji]

这个效果如何： https://easydoc.net/s/17790664/CZMqMhfW/78558034

[nekoneko]

postman 自带

[garfield12]

apifox

[star7th]

showdoc 。

github.com/star7th/showdoc

[shanyue]

Apifox 的文档 https://www.apifox.cn/apidoc/project-1608695/doc-1406337 ，看看怎么样

[unt]

@garfield12 #12
@shanyue #14 刚出来的时候就用过，ui 肯定是属于中上层没得讲，但是必须登录账号，不能自部署（要钱）加离线，🐶都不用（网络用语，非冒犯）

[unt]

@star7th #13 嗯，这些都有记录在自己的小本本上，之前用过，我再试试

[hellojukay]

openapi

[whitecosm0s]

https://gotcha.rest 支持设计 API ，编辑和复用数据模型，导出到 Swagger 或 OpenAPI 格式。你需要的“每个字段的含义可以写详细注释”完全支持，并且可以编辑约束条件，默认值示例值这些