作者a88241050 (再回頭已是百殘身)
看板Soft_Job
標題[請益] 怎麼處理API版本不同的問題?
時間Mon Jun 28 18:28:35 2021
我是後端工程師
要寫API給WEB跟APP前端
WEB跟APP有些API共用有些沒有
後端就只有一個STA版本
也就是說一個版本要同時滿足APP和WEB的需求
但我們PROD的上線時間又不是統一的
有可能今天APP要上一個新的功能
所以APP和後端都要更版
但因為WEB沒有要更新
所以後端API要同時滿足前端新舊版本的需求
講白一點就是"只能加key,不能刪key"
久而久之就會看到一隻API回了幾十個key
但實際上前端很多key都沒用到
那隻API就會變得很雜
我們現在每個Vo動不動就2,30個key
有時看程式會看得很亂
不知道大家都怎麼處理這種問題?
資深前輩是跟我說改API都一定要向前相容
因為你不能保證用戶是否用最新版本
所以key都是只加不刪嗎
--
※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 61.220.158.181 (臺灣)
※ 文章網址: https://webptt.com/m.aspx?n=bbs/Soft_Job/M.1624876117.A.086.html
1F：→ bill0205: 看樣子應該沒有做版號?06/28 18:36
2F：推 codepo: API endpoint 可以加版號上去啊 例如： /api/v1/xxx06/28 18:40
3F：推 abcf: app做強制更版機制，這樣就不用永遠向下相容06/28 18:56
呃.. 但我們同一套程式新舊兩個app是分開的
因為改動非常大，所以pm說就是用一個新的殼去包，但考量到有些用戶沒有裝我們新的
app,所以就變成後端API要讓前端新舊版本都能用
※ 編輯: a88241050 (123.192.130.8 臺灣), 06/28/2021 19:03:52
4F：→ MoonCode: 這app若不是很重要 用戶看到強更直接刪除 06/28 19:02
5F：→ fantasystar: 1. API 分版號 2. 給 Web 跟給 App 的API 拆成兩組 06/28 19:29
6F：推 BlacksPig: 不知道你的語言，java的話有幾個API版本方式可以挑著 06/28 19:39
7F：→ BlacksPig: 用，URL(上面大大提到的)、param、header、accept he 06/28 19:39
8F：→ BlacksPig: ader(produce) 06/28 19:39
9F：推 jack0204: 靠傳參數處理，沒傳就走舊的邏輯，參數來源塞哪都行 06/28 20:34
10F：推 jack0204: 最好還是把APP獨立用的接口分出來放，或加版號 06/28 20:38
11F：→ kvjo: 重點是不是先交代一下這麼多舊版本必要存在的原因 06/28 21:07
12F：→ smalldra: 第一要考驗db migration的功力 接著遲早某些版本要廢棄 06/28 21:08
13F：推 DCTmaybe: 如果全部都要相容，那為什麼要切版本? 06/28 21:11
14F：→ kvjo: 你可能沒權力決定 如果是我 這樣混亂與混用太嚴重 06/28 21:18
15F：→ kvjo: 我會直接管理面結合市場面 切一個大版本 分開出來 06/28 21:18
16F：→ kvjo: 這需要你向上管理 新版本不向後支援 你也沒聽過edge 06/28 21:19
17F：→ kvjo: 還要兼容 ie6 06/28 21:19
18F：推 jack0204: 這也要說一下中國手機超多自建的瀏覽器，爛到流湯 06/28 21:22
19F：→ jack0204: 可是有人客群在那邊，還是要支援，各種JS神奇錯誤 06/28 21:22
20F：→ jack0204: 還有CSS問題，都接近無解的 06/28 21:23
21F：→ bill0205: API不可能無限向下支援 那只會造成往後的困擾 06/28 22:27
22F：→ bill0205: 該捨棄的還是要捨棄 06/28 22:28
23F：→ hakama99: 新舊API要分開阿.. 06/28 22:59
24F：推 ldkrsi: 這年頭還要讓菜鳥去麻煩這種困擾 我覺得你們公司人的問題 06/28 23:27
25F：→ ldkrsi: 比較大 06/28 23:27
26F：→ ldkrsi: 上面推文的方法己經普遍使用超過十年 運作起來符合也符合 06/28 23:29
27F：→ ldkrsi: 你的需要 但你的前輩一直沒去調應該不是技術面問題 06/28 23:29
28F：推 viper9709: 分兩組API吧 06/29 00:15
29F：推 WaterLengend: 當初沒切清楚 後面沒人想管 今天就爛到流湯 真的覺 06/29 01:34
30F：→ WaterLengend: 得很痛苦看你要不要提議翻新，被打槍就讓他去吧 06/29 01:34
31F：推 wxywxywxy: 切版本啊 看要切在route 還是你要用一個header 06/29 09:16
32F：推 jason4571: API一定可以分更細 有新功能就塞進舊的API只代表初始階 06/29 12:44
33F：→ jason4571: 段就沒規劃好 06/29 12:44
34F：推 jinmin88: 一是api路徑帶版本，二是讀取user-agent判斷client版本 06/29 13:12
35F：→ hhsu16: 看看graphQL 06/29 18:59
36F：→ superpandal: 適時整理一波就對了 不要到變成屎山 06/29 23:20
37F：→ superpandal: 工具沒有完美的 很多都有局限性 有些甚至難用 06/29 23:24
38F：→ superpandal: 弄到很好難道不是整理的人的功勞嗎 XD 06/29 23:24
39F：→ jim7434: 只能等強制 APP 更版的時候把 API 切開了吧... 07/01 20:56
40F：→ shooter555: 靠傳參? 07/02 13:54
41F：→ shooter555: 或者用版本path隔開 舊的做成wrapper包新的api 07/02 13:57