Skip to main content
管理 API 密鑰與共享路由工作室偏好(跨多個密鑰使用,或作為團隊默認值的偏好)之間的綁定關係。如果需要更簡單的、直接在密鑰上編輯規則的密鑰優先方式,請參見 /api/v1/keys/{id}/routing-rules。 將 preference_id 設為 null 即可清除綁定;此後該密鑰在請求時將按順序繼承組織默認值 → 用戶默認值 → 無。

身份驗證

需要攜帶具有 billing API 密鑰作用域的 Bearer 令牌,並且調用方需擁有對該密鑰的訪問權限(調用方本人擁有該密鑰,或通過所在活躍組織獲得訪問權限)。

GET

讀取當前的綁定關係。

PUT

設置或清除綁定關係。
string
偏好的 UUID。傳入 null 可清除綁定。

作用域規則

  • 個人偏好只能綁定到其創建者本人擁有的密鑰。
  • 團隊偏好只能綁定到同一組織內的密鑰。
  • 跨越該邊界會返回 400 routing_preference_not_bindable,並附帶與廠商無關的提示信息。

錯誤

  • 400 routing_preference_not_bindable — 該偏好對該密鑰的作用域不可見。
  • 404 not_found — 密鑰或偏好不存在(或調用方不可見)。