Skip to main content
DELETE
永久吊销一个 Management API 密钥。与创建令牌一样,此端点位于常规的 Scanova API 主机(qcg-api.scanova.io)上,使用您正常的仪表盘 OAuth 访问令牌进行身份验证——而不是您要删除的那个密钥。

请求

string
必填
令牌创建时返回的完整密钥值(不是数字 ID)。

行为

  • 成功移除会返回带有空响应体的 204 No Content
  • 一旦被删除,该密钥会立即停止在数据主机上进行身份验证——任何正在进行中或后续使用该密钥的请求都会得到 401
  • 您只能删除自己拥有的密钥(或者,对于共享用户而言,该共享用户自己创建的密钥)。
删除操作同样会使用一个 environment 值重新检查套餐配额,如果您没有传入该值则默认为 sandbox——与创建令牌页面所述的规则相同。这在实际使用中很少造成影响,因为授予 Management API 访问权限的套餐通常会跨所有 environment 授予该权限,但如果您在删除某个 live environment 密钥时遇到意外的 401,请显式传入 ?environment=live
不存在”禁用”或”暂停”状态——移除操作是即时且永久的。如果您只是需要暂时停止使用某个密钥,请不要删除它;创建一个新密钥并停止使用旧密钥,或者在删除之前与使用该密钥的集成方协调好。

相关内容

授权

Authorization
string
header
必填

Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. management.scanova.io) — the same key sent to the regular API host will not authenticate.

路径参数

key
string
必填

响应

204

Token removed