Skip to main content
GET
密鑰技能綁定
每個 API 密鑰都可以攜帶一份顯式的技能白名單。空白名單表示該密鑰繼承你安裝的全部技能(默認行為)。非空白名單會將該密鑰限制為白名單內的技能,且在請求時與你已安裝的技能集合取交集。

身份驗證

需要具備 billing 權限範圍的 API 密鑰。調用者必須是該密鑰的所有者,或具有管理 API 密鑰權限的團隊成員。

路徑參數

string
必填
API 密鑰的 UUID。

獲取綁定關係

GET /api/v1/keys/{id}/skills
string
API 密鑰的 UUID。
boolean
當白名單為空時為 true(表示該密鑰繼承全部已安裝的技能)。
string[]
已綁定的技能 ID(當 inherits_all 為 true 時為空)。
array
每個已綁定技能的展示元數據:id、slug、name、category、is_public。

替換綁定關係

PUT /api/v1/keys/{id}/skills
string[]
必填
要綁定的完整技能 ID 集合。傳入空數組可將該密鑰重置為繼承全部已安裝的技能。
團隊作用域的密鑰只能綁定公開的、由調用者本人創建的、或歸屬於該密鑰所在團隊的技能。若任一 ID 對該密鑰不可見,請求將返回 400 skill_visibility_denied,且不會做任何變更。

示例