[请益] Websocket可用的文档工具

楼主: attacksoil (击壤)   2025-04-08 20:28:00
本宅平常都写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. 对 就是没有 要就自己写
作者: stepnight (桃卡武康)   2025-04-08 20:49:00
1,自己写一个客端测试
作者: sunbysea (忠言逆耳良药苦口)   2025-04-08 21:48:00
postman可以发websocket的request
作者: kkes0001 (kkes0308)   2025-04-08 23:26:00
因为ws 要用就是会长连接容易有状态等架构情况很多很复杂,而rest核心就是无状态然后用的人也少所以就这样了
作者: kyoe (缘份‧不再)   2025-04-09 10:01:00
不介意的话 apifox 有
作者: guanting886 (Guanting)   2025-04-09 14:09:00
一般文件写一写+模拟环境丢给团队玩
作者: superpandal   2025-04-09 20:40:00
这种自己刻一刻就好了 如果换成golang 你也不会想用swagger的 因为实现特别烂这种东西实现很简单 输入个路由类的结构再输出即可 http和ws同理 可以共用大部份逻辑写少少就可以伪躺平了 自己刻的好处
作者: B0988698088 (废文少女小円♥)   2025-04-10 08:37:00
文档是支语,请改用文件或编辑
作者: lchcoding   2025-04-10 10:11:00
B大,没那麽严重啦!大家都嘛很会猜而且,自由奔放是程式设计师的灵魂限制东限制西的程式未必写得出来^^
作者: GoalBased (Artificail Intelligence)   2025-04-10 15:31:00
我自己都用js 写一个最简单的范例,使用着不用装环境,也不会遇到他自己接不起来就说你api有问题
作者: NTUTM04 (TM终号机)   2025-04-11 09:14:00
postman试打存范例写解释,然后汇出给其他人用
作者: ntps60803orz (ntps60803)   2025-04-13 10:43:00
很会猜跟自由奔放和被语言同化到底有什么关系,这种人也能写程式,呵
作者: jobintan (Robin Artemstein)   2025-04-16 07:09:00
不喜欢支语的话以后专业术语都用英文就好了。例如Documentation或简称Doc,反正吃这行饭的,应该都很习惯在工作上用晶晶体了吧。wwwwww
作者: jacklin2002   2025-05-01 11:03:00
PostMan+1
作者: rugia813 (rugia)   2025-05-02 09:19:00
我是真的很希望就用英文就好,现在一个东西要记三份词而且写软件爱自由奔放是说团队开发都不照规范的意思吗
作者: lchcoding   2025-05-04 08:14:00
写程式,要守的规范不够多吗?不守规范程式能编译?答案能正确?效能出得来吗?规范能极小化就极小化以前,有版友问用什么笔记软件哇!那个什么都有如果规定,明天起只能用特定某一种那个做得到吗?

Links booklink

Contact Us: admin [ a t ] ucptt.com