Cuando alguien programa una conexión con GitHub, pierde horas leyendo documentación y probando a ciegas qué acepta cada llamada. Este repositorio es la descripción oficial en formato OpenAPI de toda la API REST de GitHub. Es un archivo que personas y programas leen para saber qué se puede pedir y cómo.
Para quién NO es
Si tu negocio no usa GitHub, o lo usa pero nadie de tu equipo escribe código que hable con su API, esto no te sirve de nada. No es una aplicación, no tiene pantallas ni botones y no automatiza nada por sí solo. Si lo que quieres es conectar aplicaciones sin programar, mira n8n o Activepieces y no abras este repo.
Lo incluimos por honestidad: tiene estrellas y suena útil, pero es materia prima para desarrolladores y no una herramienta para tu negocio. Para quien sí programa, su valor es ser la fuente oficial. GitHub dice que lo usa para validar las peticiones a su propia API y que se actualiza solo (el último cambio es de hoy). Por eso no acepta cambios externos: si encuentras un error, abres un issue. El error típico es tomar la carpeta `descriptions-next` como si fuera la buena. Es la versión 3.1 y puede tener cambios incompatibles. La estable es `descriptions`. Además, el propio README admite que faltan algunos headers y que no documenta todas las rutas posibles de cada operación.
Tu primer paso
Pasa el enlace del repo a quien programa tus integraciones y dile que trabaje con la carpeta descriptions en formato bundled, que es la estable y la que recomienda GitHub.
La guía de implementación de GitHub's REST API OpenAPI Description
El proyecto es de GitHub y es gratis: el link de al lado no pide nada. La guía para montarlo sin perderte es nuestra: paso a paso, errores comunes y checklist. Déjanos tu correo y te la enviamos.
Nada de spam. Puedes darte de baja cuando quieras.