curl -X DELETE "https://qcg-api.scanova.io/console/token/401f7ac837da42b97f613d789819ff93537bee6a/" \
-H "Authorization: Bearer <your_oauth_access_token>"
管理 API — 令牌与使用情况
移除一个 API 令牌
DELETE /console/token//
DELETE
/
console
/
token
/
{key}
/
curl -X DELETE "https://qcg-api.scanova.io/console/token/401f7ac837da42b97f613d789819ff93537bee6a/" \
-H "Authorization: Bearer <your_oauth_access_token>"
永久吊销一个 Management API 密钥。与创建令牌一样,此端点位于常规的 Scanova API 主机(
qcg-api.scanova.io)上,使用您正常的仪表盘 OAuth 访问令牌进行身份验证——而不是您要删除的那个密钥。
请求
DELETE https://qcg-api.scanova.io/console/token/{key}/
Authorization: Bearer <your_oauth_access_token>
string
必填
令牌创建时返回的完整密钥值(不是数字 ID)。
curl -X DELETE "https://qcg-api.scanova.io/console/token/401f7ac837da42b97f613d789819ff93537bee6a/" \
-H "Authorization: Bearer <your_oauth_access_token>"
行为
- 成功移除会返回带有空响应体的
204 No Content。 - 一旦被删除,该密钥会立即停止在数据主机上进行身份验证——任何正在进行中或后续使用该密钥的请求都会得到
401。 - 您只能删除自己拥有的密钥(或者,对于共享用户而言,该共享用户自己创建的密钥)。
删除操作同样会使用一个
environment 值重新检查套餐配额,如果您没有传入该值则默认为 sandbox——与创建令牌页面所述的规则相同。这在实际使用中很少造成影响,因为授予 Management API 访问权限的套餐通常会跨所有 environment 授予该权限,但如果您在删除某个 live environment 密钥时遇到意外的 401,请显式传入 ?environment=live。不存在”禁用”或”暂停”状态——移除操作是即时且永久的。如果您只是需要暂时停止使用某个密钥,请不要删除它;创建一个新密钥并停止使用旧密钥,或者在删除之前与使用该密钥的集成方协调好。
相关内容
- Management API 概览 —— 本端点所属的双主机身份验证架构。
- 创建一个 API 令牌 —— 生成一个替代密钥,并了解本端点共用的列表/配额规则。
- 用量统计 —— 在决定是否移除某个密钥之前查看其用量。
授权
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.
路径参数
响应
204
Token removed
此页面对您有帮助吗?
⌘I