跳至內容
Astera Technology

API 多了一個狀態值,怎樣避免自行猜意思

保留原值,暫停不安全操作;讀得懂 JSON 不代表已懂業務意思。

格式有效與狀態已定義分開看

JSON 容許字串,並不規定系統狀態意思。例子只定義 queued、complete 和 cancelled;新字串須待整合負責人更新對照。不認識的值不能全部當作成功。

假設狀態對照
原狀態本地意思可做操作
queued待處理按狀態查詢限額跟進
complete按此規格確認完成按要求做一次後續操作
paused-by-review未定義暫停不可逆操作,查規格
下載可編輯 CSV ↓

新增對照時一併加驗收個案

保留原值及規格版本供排查,排除敏感欄位。改對照要有負責人及測試,寫明准許哪些操作。解析器更新後,有意識地重處理待查紀錄,不要令它們消失。

供應商新增 reviewed,本地只認 complete,可以當作同義嗎?

查看參考答案

不能。先取得已記載意思及業務決定,規則和測試未獲批准前,保留 reviewed 為未定義原值。

相關資源