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

看板Soft_Job (軟體人)作者 (第三方程式)時間1月前 (2025/04/08 20:28), 1月前編輯推噓5(6134)
留言41則, 14人參與, 4周前最新討論串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, 1月前 , 1F
1,自己寫一個客端測試
04/08 20:49, 1F
原來是這樣... 主要是要跨團隊共享的 我們單位有時候會提供通用API給其他單位使用 所以才有類似需求 還是找錯方向/方法了? ※ 編輯: attacksoil (111.250.193.177 臺灣), 04/08/2025 20:59:11

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

04/10 10:11, 1月前 , 17F
限制東限制西的
04/10 10:11, 17F

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

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

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

04/11 09:14, 1月前 , 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

04/16 07:09, 1月前 , 24F
不喜歡支語的話以後專業術語都用英文就好了。
04/16 07:09, 24F

04/16 07:10, 1月前 , 25F
例如Documentation或簡稱Doc,反正吃這行飯的,應該都很
04/16 07:10, 25F

04/16 07:10, 1月前 , 26F
習慣在工作上用晶晶體了吧。wwwwww
04/16 07:10, 26F

05/01 11:03, 1月前 , 27F
PostMan+1
05/01 11:03, 27F

05/02 09:19, 1月前 , 28F
我是真的很希望就用英文就好,現在一個東西要記三份詞
05/02 09:19, 28F

05/02 09:20, 1月前 , 29F
而且寫軟體愛自由奔放是說團隊開發都不照規範的意思嗎
05/02 09:20, 29F

05/04 08:14, 4周前 , 30F
寫程式,要守的規範
05/04 08:14, 30F

05/04 08:14, 4周前 , 31F
不夠多嗎?不守規範
05/04 08:14, 31F

05/04 08:14, 4周前 , 32F
程式能編譯?答案能正確?
05/04 08:14, 32F

05/04 08:14, 4周前 , 33F
效能出得來嗎?
05/04 08:14, 33F

05/04 08:14, 4周前 , 34F
規範能極小化就極小化
05/04 08:14, 34F

05/04 08:14, 4周前 , 35F
以前,有版友問用甚麽筆記軟體
05/04 08:14, 35F

05/04 08:14, 4周前 , 36F
哇!那個甚麼都有
05/04 08:14, 36F

05/04 08:14, 4周前 , 37F
如果規定,明天起
05/04 08:14, 37F

05/04 08:14, 4周前 , 38F
只能用特定某一種
05/04 08:14, 38F

05/04 08:14, 4周前 , 39F
那個做得到嗎?
05/04 08:14, 39F

05/04 08:23, 4周前 , 40F
這一行好像是用“心”在工作的
05/04 08:23, 40F

05/04 08:23, 4周前 , 41F
我只知道,心不平,產能會很差
05/04 08:23, 41F
文章代碼(AID): #1dzHPI26 (Soft_Job)
文章代碼(AID): #1dzHPI26 (Soft_Job)