Repolode
google

google/go-github

Biblioteca cliente de Go para acceder a la API REST v3 de GitHub, con servicios tipados para repositorios, organizaciones, incidencias y más.

Estrellas
11,340
Forks
2,567
Issues abiertos
29
Último commit
hace 19 horas

¿Qué es?

go-github es una biblioteca cliente de Go para la API REST v3 de GitHub. La biblioteca permite crear un cliente y utilizarlo mediante grupos de servicios que reflejan la estructura de la documentación de la API de GitHub, como Repositories, Organizations y Pull Requests. Las solicitudes y respuestas se representan como structs de Go, para que quienes usan la biblioteca trabajen con datos tipados en lugar de JSON sin procesar.

La biblioteca cubre aspectos habituales al llamar directamente a la API. Incluye autenticación basada en tokens, funciones auxiliares para detectar errores de límite de solicitudes primario y secundario, paginación mediante números de página o cursores de texto, y métodos iteradores basados en el paquete iter de Go. También ofrece structs y funciones de validación para analizar cargas de webhooks de GitHub.

El proyecto es compatible con las dos versiones principales más recientes de Go y se mantiene como un módulo de Go con rutas de importación versionadas. El almacenamiento en caché de las solicitudes condicionales se delega a un transporte HTTP con caché, que el proyecto recomienda usar junto con el cliente.

Funciones clave

  • 01Structs tipados de Go para las solicitudes y respuestas de la API REST de GitHub.
  • 02Cliente organizado por servicios para reflejar la documentación de la API de GitHub.
  • 03Opciones de autenticación mediante tokens y GitHub App.
  • 04Funciones auxiliares para detectar errores de límite de solicitudes primario y secundario.
  • 05Compatibilidad con paginación mediante iteradores de números de página y cursores.
  • 06Structs y validadores para analizar eventos de webhooks de GitHub.

Casos de uso

  • Crear bots o herramientas de CI en Go que consulten o actualicen repositorios, incidencias y pull requests.
  • Desarrollar backends de GitHub App que gestionen eventos de webhooks en Go.
  • Automatizar tareas de administración de organizaciones, como enumerar miembros o gestionar equipos.
  • Escribir pruebas sobre el comportamiento de la API de GitHub mediante una biblioteca de mocks.

Inicio rápido

  1. 1

    Instala la biblioteca en tu módulo de Go

    go get github.com/google/go-github/v93
  2. 2

    Importa el paquete en tu código de Go

  3. 3

    Crea un cliente y llama a los servicios de la API

Antes de usarlo

  • Requiere una versión reciente de la cadena de herramientas de Go; el requisito mínimo es la versión mayor N-1 de Go.
  • La mayoría de los endpoints requieren un token de acceso, así que debes configurar la autenticación antes de realizar muchas llamadas.

Temas

Preguntas frecuentes

¿Qué es go-github?
Biblioteca cliente de Go para acceder a la API REST v3 de GitHub, con servicios tipados para repositorios, organizaciones, incidencias y más. go-github es una biblioteca cliente de Go para la API REST v3 de GitHub. La biblioteca permite crear un cliente y utilizarlo mediante grupos de servicios que reflejan la estructura de la documentación de la API de GitHub, como Repositories, Organizations y Pull Requests. Las solicitudes y respuestas se representan como structs de Go, para que quienes usan la biblioteca trabajen con datos tipados en lugar de JSON sin procesar.
¿go-github es gratuito? ¿Qué licencia tiene?
go-github es open source bajo la licencia BSD-3-Clause. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿go-github sigue mantenido?
Mantenimiento activo. El último commit de go-github fue el 6 nov 2026.
¿Para qué puedo usar go-github?
Crear bots o herramientas de CI en Go que consulten o actualicen repositorios, incidencias y pull requests. Desarrollar backends de GitHub App que gestionen eventos de webhooks en Go. Automatizar tareas de administración de organizaciones, como enumerar miembros o gestionar equipos. Escribir pruebas sobre el comportamiento de la API de GitHub mediante una biblioteca de mocks.
¿Cómo se instala go-github?
Instala la biblioteca en tu módulo de Go: go get github.com/google/go-github/v93 Importa el paquete en tu código de Go Crea un cliente y llama a los servicios de la API
¿Dónde consigo go-github?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/google/go-github

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados