Open Source

Documentación API (GraphQL) – Historia del Internet

Una guía para acceder a los datos del proyecto “Historia del Internet” usando GraphQL

Introducción

Este proyecto almacena información sobre la historia del internet en Colombia en una base de datos de WordPress con capacidades GraphQL. Si deseas usar nuestros datos para tus propias investigaciones, esta guía te mostrará cómo hacerlo de forma sencilla.

¿Qué es GraphQL?

GraphQL es un lenguaje para pedir datos de una API. A diferencia de las APIs tradicionales que devuelven datos fijos, con GraphQL tú eliges exactamente qué datos necesitas.

¿Cómo acceder?

URL base: https://historiasinternetpre.uniandes.edu.co/graphql

Método: POST (envías datos al servidor)

Formato: JSON

Primeros pasos

Ejemplo básico con curl (terminal)

curl -X POST https://historiasinternetpre.uniandes.edu.co/graphql \
  -H "Content-Type: application/json" \
  -d '{
    "query": "{ pages { nodes { title slug } } }"
  }'

Con JavaScript/Node.js

async function obtenerDatos(query) {
  const response = await fetch(
    'https://historiasinternetpre.uniandes.edu.co/graphql',
    {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ query })
    }
  );

  const data = await response.json();
  return data;
}

// Usar la función
const query = `{
  pages {
    nodes {
      title
      slug
    }
  }
}`;

obtenerDatos(query).then(resultado => console.log(resultado));

Con Python

import requests
import json

API_URL = "https://historiasinternetpre.uniandes.edu.co/graphql"

def obtener_datos(query):
    response = requests.post(
        API_URL,
        json={"query": query}
    )
    return response.json()

# Usar la función
query = """
{
  pages {
    nodes {
      title
      slug
    }
  }
}
"""

resultado = obtener_datos(query)
print(json.dumps(resultado, indent=2))

Tipos de datos principales

El proyecto tiene varios tipos de contenido que puedes consultar:

Tipo	Descripción	Ejemplo
pages	Páginas estáticas del sitio	Inicio, Acerca de, Investigación
eventos	Eventos históricos del internet	Nacimiento de ARPANET, primer .co
documentos	Documentos, artículos, referencias	PDFs, textos académicos
personajes	Personas importantes en la historia	Fundadores, investigadores
entrevistas	Entrevistas a personajes	Transcripciones de entrevistas
terminos	Términos del glosario	Definiciones técnicas