API 錯誤碼對照表

錯誤類別	觸發原因	排查方式
參數缺失	請求缺少必要欄位	對照環境參數說明
參數格式錯誤	欄位型別或範圍不符	檢查時間格式、數值範圍與列舉值
資源不存在	環境 ID 或分組 ID 無效	先用列表端點取得有效 ID
狀態衝突	對未啟動環境執行關閉，或重複啟動	先查詢環境執行狀態
本地服務未啟動	API 服務未開啟	在客戶端啟動本地 API 服務
權限不足	呼叫了專業版限定端點	確認版本與權限層級

重試建議

屬於狀態衝突類的錯誤，請先重新查詢狀態再決定是否重試
連線類錯誤可退避後重試，避免密集重打導致本地服務壓力
參數類錯誤不應重試，請先修正請求

相關頁面