Qué es una API · Programa con Martin

Descubre cómo se hablan las webs entre sí – y cómo la tuya puede preguntar por el tiempo, mapas o IA.

Un camarero entre dos cocinas

Imagina un restaurante. Tú (tu web) quieres pedir comida, pero no puedes entrar en la cocina (un servicio ajeno – tiempo, mapas, IA). Para eso está el camarero: toma tu pedido, lo lleva a la cocina y te trae el plato terminado.

Ese camarero se llama API (Application Programming Interface). Es una forma acordada de que los programas se pidan datos unos a otros:

Tu web envía una petición («¿Qué tiempo hará mañana en Brno?»).
La API se la pasa al servicio que sabe la respuesta.
El servicio devuelve una respuesta en un formato acordado.

Te lo muestro: JSON – un idioma común

Los programas se responden en formato JSON. Se parece casi a un objeto de JavaScript, que ya conoces del Mago:

{
  "mesto": "Brno",
  "teplota": 21,
  "slunecno": true,
  "dny": ["Saturday", "Sunday"]
}

El texto va entre comillas, los números no.
true/false ya los conoces de las condiciones.
Corchetes = una lista, llaves = un objeto.

Pruébalo ahora – abre esta dirección en el navegador (es una API de tiempo real, gratis, sin registro):

https://api.open-meteo.com/v1/forecast?latitude=49.19&longitude=16.61&current_weather=true

Verás JSON con el tiempo actual en Brno. Sin gráficos – solo datos puros. ¡Los gráficos los construyes tú!

💡

Las APIs están en todas partes. Cuando una app móvil te muestra el tiempo, un horario de autobuses o un mapa, casi nunca tiene esos datos ella sola – los pide a través de una API. Ahora aprendes a hacer lo mismo.

Ahora tú 💪

Abre la dirección de arriba en el navegador y busca la temperatura actual y la velocidad del viento en la respuesta.
Prueba a cambiar latitude y longitude en la dirección por las coordenadas de tu ciudad (búscalas en un servicio de mapas – clic derecho → «What’s here?»).
Anota 2–3 ideas para tu proyecto sobre qué datos externos serían útiles en tu web:

🏫 Web del cole – ideas

Tiempo para una excursión, un mapa con la ubicación del cole, menú del comedor desde la API del comedor (si la tiene), vacaciones y días libres.

🙋 Web personal – ideas

Tiempo en tu ciudad, un mapa de sitios donde has estado, un chatbot con IA que responda preguntas sobre ti a los visitantes.

🌍 Diario de viajes – ideas

Un mapa con chinchetas de tus viajes, tiempo en el próximo destino, conversión de moneda para tu presupuesto de viaje.

⚽ Web del club – ideas

Tiempo para el partido del fin de semana, mapa del campo para equipos visitantes, un ayudante con IA que explique las reglas del fútbol.

✅

Compruébalo: Puedes explicar qué es una API (un camarero entre programas) y reconocer JSON. Has visto una respuesta real de una API en el navegador.

Lo que te llevas de esta lección

API = una forma acordada de que los programas se pidan datos unos a otros.
Las respuestas vienen en JSON – objetos y listas como en JavaScript.
En la siguiente lección traerás datos de una API directamente a tu web con fetch.