處理 API 錯誤同重試

喺閱讀響應作為成功之前，始終檢查 HTTP 狀態。ShareAI 服務可以返回唔同嘅錯誤封裝：推理可能提供 error.code，OAuth 提供 error 同埋 error_description，控制台路由可以返回 code, message 同埋 data.status.

狀態	典型含義	恢復
200 同埋一個錯誤對象	無設備可用結果喺而家嘅聊天端點。	檢查 error.code，唔好將佢作為助手答案呈現。
400	無效請求或者 OAuth 授權。	更正內容、參數、回調或者過期/已用嘅代碼。
401	缺失、過期或者無效嘅身份驗證。	檢查憑證；只刷新有效嘅OAuth授權。
402	資金不足或者適用餘額不足。	重試之前，檢查所選賬戶餘額。
403	範圍、擁有權、角色或者啟用狀態被拒。	檢查文件記錄嘅權限邊界。
404	未知資源或者不支持嘅網關路由。	檢查主機、路徑同資源標識符。
409	狀態或者修訂衝突。	閱讀當前狀態，重新考慮更改。
429	請求或者並發限制。	遵守Retry-After，並使用有限嘅回退策略。
500 / 502 / 503	伺服器或者上游可用性失敗。	保持重試次數有限；保留診斷標識符。

限制重試閱讀#

對於讀取嘅臨時失敗，增加延遲同抖動等待，當Retry-After存在時遵守，並喺定義嘅嘗試次數或者時間限制後停止。當數據不可用時，向用戶顯示，而唔係無限循環。

小心處理寫入#

當結果未知時，唔好自動重複價格更新、模型創建或者共享命令。首先閱讀資源或者命令狀態。只喺文件支持嘅端點使用Idempotency-Key，例如協議更改。

刷新令牌係一次性使用#

刷新輪換需要喺後端進行每次授權鎖定。盲目重試已用嘅刷新令牌可能會撤銷授權。參閱 安全令牌刷新.

支援請求應包括嘅內容#

當可用時，包含端點、HTTP狀態、錯誤代碼、時間同響應/任務標識符。移除Authorization標頭、cookies、客戶端密鑰、訪問令牌、刷新令牌同私人提示內容。