Skip to main content
REST API 现已开始进行版本化。 有关详细信息,请参阅“关于 API 版本控制”。

撤销

使用 REST API 撤销在 GitHub 或其他位置公开的凭据。

Revoke a list of credentials

Submit a list of credentials to be revoked. This endpoint is intended to revoke credentials the caller does not own and may have found exposed on GitHub.com or elsewhere. Credential owners will be notified of the revocation.

This endpoint currently accepts the following credential types:

  • Personal access tokens (classic) (ghp_)
  • Fine-grained personal access tokens (github_pat_)

To prevent abuse, this API is limited to 60 authenticated requests per hour and a max of 1000 tokens per API request.

fine_grained_access

no_fine_grained_access

“”Revoke a list of credentials 的参数

标头
名称, 类型, 说明
accept string

Setting to application/vnd.github+json is recommended.

主体参数
名称, 类型, 说明
credentials array of strings 必须

A list of credentials to be revoked, up to 1000 per request.

http_status_code

status_code说明
202

Accepted

422

Validation failed, or the endpoint has been spammed.

500

Internal Error

code_samples

request_example

post/credentials/revoke
curl -L \ -X POST \ -H "Accept: application/vnd.github+json" \ -H "Authorization: Bearer <YOUR-TOKEN>" \ -H "X-GitHub-Api-Version: 2022-11-28" \ http(s)://HOSTNAME/api/v3/credentials/revoke \ -d '{"credentials":["ghp_1234567890abcdef1234567890abcdef12345678","github_pat_0A1B2C3D4E5F6G7H8I9J0K_ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456","gho_1234567890abcdef1234567890abcdef12345678","ghu_1234567890abcdef1234567890abcdef12345678","ghr_1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab"]}'

Accepted

Status: 202