Skip to main content
Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

Solución de problemas

Aprende cómo resolver los problemas más comunes que las personas pueden encontrar en la API de REST.

Si estás encontrando algunas situaciones extrañas en la API, aquí hay una lista de posibles soluciones a algunos de estos problemas que podrías estar experimentando.

Error 404 para un repositorio existente

Habitualmente, enviamos un error 404 cuando tu cliente no está autenticado adecuadamente. Puede que esperes ver un 403 Forbidden en estos casos. Sin embargo, ya que no queremos proporcionar ningun tipo de información acerca de los repositorios privados, en vez de esto, la API devuelve un 404.

Para solucionar problemas, asegúrate de que te estás autenticando correctamente, que tu token de acceso OAuth tenga los alcances requeridos, que las restricciones de aplicaciones de terceros no estén bloqueando el acceso y que el token no haya vencido ni se haya revocado.

No se devolvieron todos los resultados

La mayoría de las llamadas a la API que acceden a una lista de recursos (por ejemplo, usuarios, informes de problemas, etc.) son compatibles con la paginación. Si estás haciendo solicitudes y recibes un conjunto de resultados incompleto, probablemente solo estás viendo la primera página. Necesitarás solicitar las páginas restantes para obtener más resultados.

Es importante que no intentes adivinar el formato de la URL de paginación. No todas las llamadas a la API utilizan la misma estructura. En vez de esto, extrae la información de paginación del Encabezado de Enlace, el cual se envía en cada solicitud.

Errores de autenticación básicos

Desde el 13 de noviembre de 2020, la autenticación con nombre de usuario y contraseña a la API de REST y a la API de Autorizaciones de OAuth se obsoletizaron y ya no funcionan.

Utilizar username/password para la autenticación básica

Si estás utilizando username y password para las llamadas a la API, éstas credenciales ya no funcionarán para que te autentiques. Por ejemplo:

curl -u my_user:my_password https://api.github.com/user/repos

En vez de esto, utiliza un token de acceso personal cuando pruebes las terminales o cuando realices desarrollos locales:

curl -H 'Authorization: token my_access_token' https://api.github.com/user/repos

Para las Apps de Oauth, debes utilizar el flujo de aplicaciones web para generar un token de OAuth para utilizar el encabezado de la llamada a la API:

curl -H 'Authorization: token my-oauth-token' https://api.github.com/user/repos

Llamadas a la API de Autorizciones de OAuth

Si estás haciendo llamadas a la API de Autorizaciones de OAuth para administrar las autorizaciones de tu app de OAuth o para generar tokens de acceso de forma similar a este ejemplo:

curl -u my_username:my_password -X POST "https://api.github.com/authorizations" -d '{"scopes":["public_repo"], "note":"my token", "client_id":"my_client_id", "client_secret":"my_client_secret"}'

Entonces debes cambiar al flujo de aplicaciones web para generar tokens de acceso.

Exceder el tiempo de espera

Si a GitHub le toma más de 10 segundos procesar una solicitud de la API, GitHub terminará la solicitud y recibirás una respuesta de tiempo de espera excedido.