🌐 通用規則

錯誤訊息

HTTP Status Code 為 4xx 或 5xx 皆視為連線失敗。

5xx：Autopass 端伺服器異常。若多次嘗試後仍發生 5xx，請與 Autopass（車麻吉）人員聯絡。

422：系統處理商業邏輯時發生的異常（例如嘗試註冊已註冊過的車輛識別）。回應格式：

{ "errorCode": "錯誤代碼", "errorMessage": "錯誤訊息" }

錢包業者需依 errorCode 處理相應邏輯，並依情境呈現給用戶。各 API 個別的 errorCode 列表請見 autopass-openapi.yaml 中對應 422 回應的說明。

其餘 4xx：多為資料格式錯誤，或嘗試執行不被允許的操作（如資源不存在 404、AccessToken 錯誤 401）。回應格式：

{ "error": "錯誤訊息" }

金額：一律以「元」為單位，且在 API 傳遞時均轉換成字串格式。Server 與 Client 收到後應各自轉換成十進位數字處理，請勿轉換成浮點數，以免發生精度異常。

時間：一律以 ISO 8601 字串格式交換，例如 2018-01-01T00:00:00+08:00。