觀點

當介面文件與 App 實際呼叫對不上

筆記與筆電並排的工作桌

文件過時很少是單一事故造成的。更常見的是:後端先上線相容欄位、客戶端某次熱修繞過閘道、或測試環境的路徑被誤帶進正式建置。

稽核時我們會先問:這支端點最後一次被哪個版本呼叫?誰有權限改它?若今夜失敗,客服話術對得上錯誤碼嗎?答不出來的路徑,往往是風險來源。

收斂不是刪光舊版支援。留下的介面需要清楚的版本策略、可驗證的錯誤契約,以及棄用時程。其餘應標記為觀察或關閉。

若團隊剛換 API 閘道或 BFF,舊路徑常被原封代理。那是整理的好時機:以實際流量反推「仍需要的契約」,而不是複製歷史累積。