GitHub no solamente almacena codigo en sus Repos

PYTHON · APIs · PRINCIPIANTES

Conecta Python con el mundo real usando APIs

Aprende a hablar con servicios externos desde tu código: qué es una API, cómo funciona el protocolo HTTP y cómo extraer datos reales de GitHub con solo unas pocas líneas.

Nivel: principiante Lectura: ~8 min Librería: requests

▶ Video del tema

Conceptos clave

Antes de escribir una sola línea de código, conviene tener claros estos cuatro términos. Los verás mencionados en cada proyecto que consuma datos externos.

🔌

API

Application Programming Interface. Un contrato que define cómo dos programas pueden comunicarse entre sí. Es el "menú" de lo que un servicio te deja pedir.

📡

HTTP

El protocolo que usan los navegadores y tu código para enviar y recibir información por internet. Toda API web habla HTTP.

📦

JSON

JavaScript Object Notation. El formato de texto más común para intercambiar datos entre una API y tu programa. Python lo convierte en un diccionario automáticamente.

🔑

Endpoint

La URL específica a la que le haces la petición. Cada endpoint representa un recurso distinto, por ejemplo /repos/torvalds/linux.

Códigos de estado HTTP

Cada vez que haces una petición, el servidor te responde con un número de tres dígitos que resume qué pasó. Son el semáforo de las APIs.

Código	Nombre	Qué significa
200	OK	Todo salió bien. La respuesta incluye los datos que pediste.
201	Created	Se creó un recurso nuevo con éxito.
400	Bad Request	Tu petición tiene errores de formato o faltan parámetros.
401	Unauthorized	No enviaste credenciales o son inválidas.
404	Not Found	El recurso que pediste no existe en esa URL.
500	Server Error	El fallo es del lado del servidor, no de tu código.

Tu primera petición a la API de GitHub

La librería requests hace todo el trabajo pesado. Instalación rápida desde tu terminal:

terminal

pip install requests

Con la librería instalada, esta es la petición más básica:

ejemplo_01.py

import requests

# 1. Haces la petición al endpoint
r = requests.get( "https://api.github.com/repos/torvalds/linux" )

# 2. Código de estado
print( f"Estado: {r.status_code}" )

# 3. Contenido JSON → diccionario Python
print( r.json() )

¿Qué ocurre bajo el capó?

Cuando llamas a requests.get(), Python abre una conexión con los servidores de GitHub, envía una petición HTTP GET y espera la respuesta.

El objeto r contiene el código de estado, las cabeceras y el cuerpo con los datos.

Propiedades del objeto Response

El objeto que devuelve requests.get() tiene varios atributos y métodos útiles:

Propiedad / Método	Tipo	Para qué sirve
r.status_code	int	Código numérico de la respuesta.
r.json()	dict / list	Convierte el cuerpo JSON a un objeto Python.
r.text	str	Cuerpo de la respuesta como texto.
r.headers	dict	Cabeceras HTTP que mandó el servidor.
r.url	str	URL final de la petición.
r.ok	bool	True si el código es menor a 400.

Ejemplo completo: reporte del repositorio de Linux

Este script extrae los campos más interesantes y los muestra de forma organizada en tu terminal.

reporte_github.py

import requests

url = "https://api.github.com/repos/torvalds/linux"

try:

    r = requests.get( url, timeout=10 )
    r.raise_for_status()

    datos = r.json()

    print( "-" * 50 )
    print( f"REPOSITORIO: {datos['full_name'].upper()}" )
    print( "-" * 50 )

    # Popularidad
    print( f"⭐ Estrellas: {datos['stargazers_count']:,}" )
    print( f"👁️ Observadores: {datos['subscribers_count']:,}" )
    print( f"🍴 Forks: {datos['forks_count']:,}" )
    print( f"🐛 Issues abiertos: {datos['open_issues_count']:,}" )

    # Detalles
    descripcion = datos.get( "description" ) or "No disponible"

    licencia = (
        datos[ "license" ][ "name" ]
        if datos.get( "license" )
        else "No especificada"
    )

    sitio_web = datos.get( "homepage" ) or "No disponible"

    print( f"📝 Descripción: {descripcion}" )
    print( f"⚖️ Licencia: {licencia}" )
    print( f"🌐 Sitio web: {sitio_web}" )

    # Fechas
    print( f"📅 Creado: {datos['created_at']}" )
    print( f"🔄 Última push: {datos['pushed_at']}" )

    print( "-" * 50 )

except requests.exceptions.HTTPError as e:
    print( f"❌ Error HTTP: {e}" )

except requests.exceptions.ConnectionError:
    print( "❌ No hay conexión a Internet." )

except requests.exceptions.Timeout:
    print( "❌ La petición tardó demasiado." )

except requests.exceptions.RequestException as e:
    print( f"❌ Error al realizar la petición: {e}" )

Resultado en tu terminal

OUTPUT

──────────────────────────────────────────────────

REPOSITORIO: TORVALDS/LINUX

──────────────────────────────────────────────────

⭐ Estrellas: 177,412

👁️ Observadores: 8,240

🍴 Forks: 52,890

🐛 Issues abiertos: 371

📝 Descripción: Linux kernel source tree

⚖️ Licencia: GNU General Public License v2.0

🌐 Sitio web: https://kernel.org

📅 Creado: 2011-09-04T22:48:12Z

🔄 Última push: 2026-06-18T14:22:07Z

──────────────────────────────────────────────────

💡 Truco: Los números de estrellas y forks cambian en tiempo real. Cada vez que ejecutes el script verás valores diferentes. ¡Tu código está leyendo datos vivos de internet!

Explora qué más puedes pedir

La API de GitHub devuelve docenas de campos por repositorio. Para ver todas las claves disponibles puedes utilizar:

explorar_claves.py

# Ver TODAS las claves que devuelve la API
print( "\n📋 Claves disponibles:" )
for clave in sorted( datos.keys() ):
    print( f" → {clave}" )

Algunos de los campos más útiles que encontrarás:

language

Lenguaje de programación principal del repositorio.

visibility

Si el repositorio es public o private.

default_branch

Nombre de la rama principal.

size

Tamaño del repositorio en kilobytes.

topics

Lista de etiquetas temáticas del repositorio.

owner.login

Nombre de usuario del propietario.

Resumen

Con tres líneas de Python puedes comenzar a hablar con prácticamente cualquier API:

01 · IMPORTA

import requests — la librería que gestiona las conexiones HTTP por ti.

02 · PIDE

requests.get(url) — envía la petición y espera la respuesta.

03 · USA

r.json() — convierte la respuesta en un diccionario Python.

jesus@el-informatico: ~/python/apis$ python reporte_github.py

✔ API conectada correctamente

✔ Datos recibidos desde GitHub

✔ JSON convertido a objeto Python

REGRESAR AL INICIO

¿Quieres continuar explorando más contenido de El Informatico?

🖥️ INICIO →