L’API REST est maintenant versionnée. Pour plus d’informations, consultez « À propos des versions de l’API ».

Révocation

Utilisez l’API REST pour révoquer les informations d’identification que vous avez trouvées exposées sur GitHub ou ailleurs.

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:

  • classic personal access tokens
  • fine-grained personal access tokens

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

Jetons d’accès affinés pour « Revoke a list of credentials »

Ce point de terminaison fonctionne avec les types de jetons précis suivants:

Le jeton précis ne nécessite aucune autorisation.

Paramètres pour « Revoke a list of credentials »

En-têtes
accept string

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

Paramètres du corps
credentials array of strings Obligatoire

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

Codes d’état de la réponse HTTP pour « Revoke a list of credentials »

Code d’étatDescription
202

Accepted

422

Validation failed, or the endpoint has been spammed.

500

Internal Error

Exemples de code pour « Revoke a list of credentials »

Exemple de requête

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","ghp_abcdef1234567890abcdef1234567890abcdef12"]}'

Accepted

Status: 202