DELETE/api/v1/me/authorizations/:grantId撤销一个三方授权

撤销对指定应用的授权;该应用已签发的访问令牌立即失效(opaque 即刻失效,jwt 在下一次校验时因授权缺失被拒)。

Request

Headers

NameData TypeRequiredDescription
AuthorizationstringYes会话令牌认证,格式 `Bearer <sessionToken>`
type RequestHeaders = {
  /** 会话令牌认证,格式 `Bearer <sessionToken>` */
  Authorization: string
}

URL Parameters

Name Data Type Description
grantId string 授权记录 ID

Response

Body

result type: null

HTTP Code

HTTP Status Meaning Notes
200 成功 授权已撤销

Response Code

响应使用统一信封 {id, code, messages, result},其 code 字段:

code Meaning Notes
0 成功 授权已撤销,相关令牌失效

Examples

DELETE /api/v1/me/authorizations/01JD8SNS9N1T4W0AT5X8AGN2Y6H
Authorization: Bearer st_7c1f9e05b28d4a63
{
  "id": "01JD8SOPWJ4J6R3",
  "code": 0,
  "messages": [],
  "result": null
}

Remarks

撤销是即时全量的:该应用对当前用户的所有访问能力一并收回。