/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— 密鑰或偏好不存在(或調用方不可見)。
