[請益] Websocket可用的文檔工具

看板Soft_Job (軟體人)作者 (第三方程式)時間6天前 (2025/04/08 20:28), 6天前編輯推噓2(3119)
留言23則, 11人參與, 1天前最新討論串1/1
本宅平常都寫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://www.ptt.cc/bbs/Soft_Job/M.1744115282.A.086.html

04/08 20:49, 6天前 , 1F
1,自己寫一個客端測試
04/08 20:49, 1F
原來是這樣... 主要是要跨團隊共享的 我們單位有時候會提供通用API給其他單位使用 所以才有類似需求 還是找錯方向/方法了? ※ 編輯: attacksoil (111.250.193.177 臺灣), 04/08/2025 20:59:11

04/08 21:48, 5天前 , 2F
postman可以發websocket的request
04/08 21:48, 2F

04/08 23:26, 5天前 , 3F
因為ws 要用就是會長連接容易有狀態等架構情況很多很複
04/08 23:26, 3F

04/08 23:26, 5天前 , 4F
雜,而rest核心就是無狀態
04/08 23:26, 4F

04/08 23:26, 5天前 , 5F
然後用的人也少所以就這樣了
04/08 23:26, 5F

04/09 10:01, 5天前 , 6F
不介意的話 apifox 有
04/09 10:01, 6F

04/09 14:09, 5天前 , 7F
一般文件寫一寫+模擬環境丟給團隊玩
04/09 14:09, 7F

04/09 20:40, 5天前 , 8F
這種自己刻一刻就好了 如果換成golang 你也不會想用s
04/09 20:40, 8F

04/09 20:41, 5天前 , 9F
wagger的 因為實現特別爛
04/09 20:41, 9F

04/09 20:46, 5天前 , 10F
這種東西實現很簡單 輸入個路由類的結構再輸出即可 h
04/09 20:46, 10F

04/09 20:47, 5天前 , 11F
ttp和ws同理 可以共用大部份邏輯
04/09 20:47, 11F

04/09 20:48, 5天前 , 12F
寫少少就可以偽躺平了 自己刻的好處
04/09 20:48, 12F

04/10 08:37, 4天前 , 13F
文檔是支語,請改用文件或編輯
04/10 08:37, 13F

04/10 10:11, 4天前 , 14F
B大,沒那麽嚴重啦!
04/10 10:11, 14F

04/10 10:11, 4天前 , 15F
大家都嘛很會猜
04/10 10:11, 15F

04/10 10:11, 4天前 , 16F
而且,自由奔放是程式設計師的靈魂
04/10 10:11, 16F

04/10 10:11, 4天前 , 17F
限制東限制西的
04/10 10:11, 17F

04/10 10:11, 4天前 , 18F
程式未必寫得出來^^
04/10 10:11, 18F

04/10 15:31, 4天前 , 19F
我自己都用js 寫一個最簡單的範例,使用著不用裝環境,
04/10 15:31, 19F

04/10 15:31, 4天前 , 20F
也不會遇到他自己接不起來就說你api有問題
04/10 15:31, 20F

04/11 09:14, 3天前 , 21F
postman試打存範例寫解釋,然後匯出給其他人用
04/11 09:14, 21F

04/13 10:43, 1天前 , 22F
很會猜跟自由奔放和被語言同化到底有什麼關係,這種
04/13 10:43, 22F

04/13 10:43, 1天前 , 23F
人也能寫程式,呵
04/13 10:43, 23F
文章代碼(AID): #1dzHPI26 (Soft_Job)
文章代碼(AID): #1dzHPI26 (Soft_Job)