作者attacksoil (第三方程式)
看板Soft_Job
标题[请益] Websocket可用的文档工具
时间Tue Apr 8 20:28:00 2025
本宅平常都写REST API後端比较多 无脑用Swagger文档
结果最近一个专案会用到Websocket Swagger不支援
查了一下 支持OpenAPI的文档伺服器超级多
Mintlify Readme Stoplight 一大堆
但是支持Websocket的只找到一个AsyncAPI
而且还没有sent request/try it out功能
而且感觉UI也比不上上面说的那几个
请问为什麽会这样?
1. websocket本来就不适合或不需要try it out
2. websocket相较REST用的人太少
3. 单纯没找到
4. 对 就是没有 要就自己写
--
※ 发信站: 批踢踢实业坊(ptt.cc), 来自: 111.250.193.177 (台湾)
※ 文章网址: https://webptt.com/cn.aspx?n=bbs/Soft_Job/M.1744115282.A.086.html
1F：→ stepnight: 1，自己写一个客端测试 04/08 20:49
原来是这样... 主要是要跨团队共享的
我们单位有时候会提供通用API给其他单位使用
所以才有类似需求 还是找错方向/方法了?
※ 编辑: attacksoil (111.250.193.177 台湾), 04/08/2025 20:59:11
2F：推 sunbysea: postman可以发websocket的request 04/08 21:48
3F：推 kkes0001: 因为ws 要用就是会长连接容易有状态等架构情况很多很复 04/08 23:26
4F：→ kkes0001: 杂，而rest核心就是无状态 04/08 23:26
5F：→ kkes0001: 然後用的人也少所以就这样了 04/08 23:26
6F：推 kyoe: 不介意的话 apifox 有 04/09 10:01
7F：→ guanting886: 一般文件写一写+模拟环境丢给团队玩 04/09 14:09
8F：→ superpandal: 这种自己刻一刻就好了 如果换成golang 你也不会想用s 04/09 20:40
9F：→ superpandal: wagger的 因为实现特别烂 04/09 20:41
10F：→ superpandal: 这种东西实现很简单 输入个路由类的结构再输出即可 h 04/09 20:46
11F：→ superpandal: ttp和ws同理 可以共用大部份逻辑 04/09 20:47
12F：→ superpandal: 写少少就可以伪躺平了 自己刻的好处 04/09 20:48
13F：嘘 B0988698088: 文档是支语，请改用文件或编辑 04/10 08:37
14F：→ lchcoding: B大，没那麽严重啦！ 04/10 10:11
15F：→ lchcoding: 大家都嘛很会猜 04/10 10:11
16F：→ lchcoding: 而且，自由奔放是程式设计师的灵魂 04/10 10:11
17F：→ lchcoding: 限制东限制西的 04/10 10:11
18F：→ lchcoding: 程式未必写得出来^^ 04/10 10:11
19F：→ GoalBased: 我自己都用js 写一个最简单的范例，使用着不用装环境， 04/10 15:31
20F：→ GoalBased: 也不会遇到他自己接不起来就说你api有问题 04/10 15:31
21F：→ NTUTM04: postman试打存范例写解释，然後汇出给其他人用 04/11 09:14
22F：→ ntps60803orz: 很会猜跟自由奔放和被语言同化到底有什麽关系，这种 04/13 10:43
23F：→ ntps60803orz: 人也能写程式，呵 04/13 10:43
24F：推 jobintan: 不喜欢支语的话以後专业术语都用英文就好了。 04/16 07:09
25F：→ jobintan: 例如Documentation或简称Doc，反正吃这行饭的，应该都很 04/16 07:10
26F：→ jobintan: 习惯在工作上用晶晶体了吧。wwwwww 04/16 07:10
27F：推 jacklin2002: PostMan+1 05/01 11:03
28F：推 rugia813: 我是真的很希望就用英文就好，现在一个东西要记三份词 05/02 09:19
29F：→ rugia813: 而且写软体爱自由奔放是说团队开发都不照规范的意思吗 05/02 09:20
30F：→ lchcoding: 写程式，要守的规范 05/04 08:14
31F：→ lchcoding: 不够多吗？不守规范 05/04 08:14
32F：→ lchcoding: 程式能编译？答案能正确？ 05/04 08:14
33F：→ lchcoding: 效能出得来吗？ 05/04 08:14
34F：→ lchcoding: 规范能极小化就极小化 05/04 08:14
35F：→ lchcoding: 以前，有版友问用甚麽笔记软体 05/04 08:14
36F：→ lchcoding: 哇！那个甚麽都有 05/04 08:14
37F：→ lchcoding: 如果规定，明天起 05/04 08:14
38F：→ lchcoding: 只能用特定某一种 05/04 08:14
39F：→ lchcoding: 那个做得到吗？ 05/04 08:14
40F：→ lchcoding: 这一行好像是用“心”在工作的 05/04 08:23
41F：→ lchcoding: 我只知道，心不平，产能会很差 05/04 08:23