吊销 ROUTER API 密钥接口

按标识符立即吊销咏唱引擎 ROUTER 中的 API 密钥。该密钥对后续所有请求失效。

使用吊销密钥接口永久使一个已有 API 密钥失效。吊销后，任何使用该密钥的请求都会返回认证错误。该操作是即时且不可逆的。

任何已认证调用者都可以调用此接口，但调用者不能吊销权限作用域高于自身作用域的密钥。

接口

DELETE /v1/router/keys/{id}

认证

使用会话 Cookie 认证，或携带 Authorization: Bearer <api-key>。

路径参数

id · string · required

要吊销的 API 密钥的唯一标识符。

响应

吊销成功返回 HTTP 204，无响应体。

cURL

curl -X DELETE "https://router.example.com/v1/router/keys/key_01hv8" \
  -H "Authorization: Bearer <api-key>"

204