请问各位，公司内部的接口文档是怎么管理的？

2017-09-12 19:48:51 +08:00
 MrXiong
  1. 公司准备使用 swagger，基于注解的方式，但是发现多个项目无法集成，很不方便
  2. swagger-ui 中没有接口的搜索功能

请问各位还有啥比较好用的轮子？

18699 次点击
所在节点    Java
119 条回复
byuc
2017-09-12 19:53:08 +08:00
口口相传
qinxi
2017-09-12 19:53:50 +08:00
https://app.swaggerhub.com/ 这个?
yoa1q7y
2017-09-12 19:56:25 +08:00
口口相传+1
sudoz
2017-09-12 19:56:51 +08:00
confluence
Hypn0s
2017-09-12 19:59:42 +08:00
confluence + 1
gaayyy
2017-09-12 20:03:59 +08:00
靠猜
nieyujiang
2017-09-12 20:04:10 +08:00
给你一个眼神,自己体会.🌚
fengxuejianshi
2017-09-12 20:18:15 +08:00
意念
aaxcc
2017-09-12 20:33:59 +08:00
当然是打印出来贴在公司大门上，每天程序猿进门背一个借口，背错的扣工资
cutlove
2017-09-12 20:43:57 +08:00
apizza
irgil
2017-09-12 20:45:40 +08:00
swagger，或者公司自研的。
orancho
2017-09-12 20:47:17 +08:00
protobuf / grpc 的 proto 文件
MrXiong
2017-09-12 20:51:46 +08:00
@irgil swagger 有什么使用姿势
irgil
2017-09-12 21:28:12 +08:00
@MrXiong 主要是自动生成文档，自动生成代码
AndyJia
2017-09-12 22:23:45 +08:00
openapi
gemini
2017-09-12 22:29:09 +08:00
word 文档不挺好的么
iyaozhen
2017-09-12 22:30:12 +08:00
wiki，先定接口再开发
crossoverJie
2017-09-12 22:31:43 +08:00
之前 confluence 现在 swagger
hasbug
2017-09-12 22:43:24 +08:00
口口相传+1
m939594960
2017-09-12 22:44:40 +08:00
gitlab 的 wiki 功能

这是一个专为移动设备优化的页面（即为了让你能够在 Google 搜索结果里秒开这个页面），如果你希望参与 V2EX 社区的讨论，你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/390148

V2EX 是创意工作者们的社区，是一个分享自己正在做的有趣事物、交流想法，可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX