Skip to main content
Ahora la API de REST tiene control de versiones. Para obtener más información, consulta "Acerca del control de versiones de la API".

Revocación

Usa la API de REST para revocar las credenciales que has encontrado expuestas en GitHub o en otro lugar.

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.

Tokens de acceso específicos para "Revoke a list of credentials"

Este punto de conexión funciona con los siguientes tipos de token pormenorizados:

El token pormenorizado no requiere ningún permiso.

Parámetros para "Revoke a list of credentials"

Encabezados
Nombre, Tipo, Descripción
accept string

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

Parámetros del cuerpo
Nombre, Tipo, Descripción
credentials array of strings Requerido

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

Códigos de estado de respuesta HTTP para "Revoke a list of credentials"

status codeDescripción
202

Accepted

422

Validation failed, or the endpoint has been spammed.

500

Internal Error

Ejemplos de código para "Revoke a list of credentials"

Ejemplo de solicitud

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