版本與升級 | AppForges Developer Center

請求與回顯

公共REST路徑使用 /v1/。請求日期版本的規範頭是 X-AppForges-Api-Version；以 X-AppForges-Resolved-Api-Version 查看服務器實際解析的版本。

curl --fail-with-body "${APPFORGES_API_BASE_URL}/v1/users/me" \
  -H "Authorization: Bearer ${APPFORGES_ACCESS_TOKEN}" \
  -H "X-AppForges-Api-Version: 2026-04-01"

服務端當前兼容舊請求頭 API-Version，新接入使用規範名。未顯式指定時由服務端解析默認版本，不要假設應用創建日期提供獨立schema隔離；檢查實際回顯。格式非法或未知版本可能返回400及 API_VERSION_INVALID / API_VERSION_UNKNOWN。

SDK與日期版本

SDK正式包版本 0.59.4 跟隨protos/spec tag；它不是API日期版本。升級SDK前閱讀對應包內CHANGELOG和公開release notes，運行自己的契約測試。

發佈流水線比較共享API合同；0.x破壞變化必須提升MINOR，兼容PATCH仍需源碼審閱。新增枚舉值對窮舉消費者也可能造成破壞，不能一律視為兼容。

棄用與遷移

實際網關在deprecated端點可發送標準 Deprecation，beta端點可發送 Warning。當前不承諾自動Sunset日期、日期到期統一410或固定六個月遷移窗口。版本頭解析也不意味著服務器實現了任意歷史schema轉換。

升級前查看API Reference和Changelog，在staging用合法憑據完成測試，記錄請求ID和版本回顯，再部署客戶端；保留已驗證版本用於回退。應用Settings中的默認版本設置不能代替逐端點兼容性驗證。

參見快速開始、錯誤與重試。