API de GitHub: qué puedes hacer y cómo usarla con agentes de IA
La API de GitHub expone casi todo lo que se hace en la interfaz: repositorios, issues, pull requests, revisiones, Actions, releases y organización. La usan equipos de ingeniería, DevOps y herramientas de automatización. Hay API REST y GraphQL, con acceso por token personal, GitHub App u OAuth.
Qué ofrece la API de GitHub
Repositorios y contenido
Lectura de archivos, ramas y commits, y comparación entre versiones.
Issues
Creación, etiquetas, responsables, hitos y comentarios.
Pull requests y revisiones
Apertura, comentarios de revisión, estado y merge.
GitHub Actions
Ejecuciones de workflows, registros, artefactos y activación manual.
Releases
Publicación de versiones con notas y archivos adjuntos.
Organizaciones y equipos
Miembros, equipos y permisos de repositorio.
Webhooks
Eventos de push, PR, issue y workflow enviados a tu endpoint.
Cómo acceder a la API de GitHub
- API públicaToken de acceso personal (de preferencia de permisos granulares), GitHub App instalada en la organización u OAuth. Para agentes, una GitHub App con permisos por repositorio suele ser la opción más segura.
- Hay límites de solicitudes por hora; las GitHub Apps tienen límites mayores que los tokens personales.
- No des nunca a un agente permisos de administración del repositorio.
- Cuidado con los secretos en registros y código: el agente no debe copiarlos en los mensajes.
Documentación oficial: docs.github.com/rest
Qué hace un agente de iTeam con la API de GitHub
Triaje de issues
El agente lee cada issue nueva, pide la información que falta, aplica etiquetas de área y prioridad y sugiere un responsable según el historial del código.
Resumen del PR para quien revisa
Al abrirse un pull request, el agente comenta el resumen de los cambios, los archivos de mayor riesgo y qué probar.
Workflow que falló
Cuando el CI se rompe en main, el agente lee el registro de Actions, identifica el paso y el commit probable y avisa al equipo en Slack con el enlace.
Notas de release
A la hora de publicar, el agente reúne los PR integrados desde la última versión y redacta las notas para su aprobación.
De la credencial al agente trabajando, con aprobación
Crea una GitHub App o un token de permisos granulares
TI define en qué repositorios y con qué permisos, por ejemplo issues con escritura y contenido solo lectura.
Regístralo en la bóveda de iTeam
La credencial queda en la bóveda y cada agente recibe solo las acciones permitidas; el agente de triaje no hace merge.
Prueba con aprobación
Los comentarios y las etiquetas pueden ejecutarse directamente; los merges, los releases y la activación de workflows pasan por aprobación humana.
Equipos de IA listos para este trabajo
Preguntas sobre la API de GitHub
¿La API de GitHub es gratuita?
En general, sí: la API está disponible en todos los planes, con límites de uso. Recursos como Actions consumen minutos según el plan.
¿Necesito programar para usar la API de GitHub con iTeam?
No necesariamente. GitHub tiene un conector listo en el catálogo y el equipo de implantación configura los flujos contigo.
¿REST o GraphQL?
Existen las dos. REST es más sencilla para acciones puntuales; GraphQL ayuda a obtener muchos datos relacionados en una sola llamada.
