作者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/m.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