[請益] 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