Tu aplicación necesita datos que no viven en el navegador, sino en un servidor del otro lado del mundo. Para traerlos, necesitas entender qué es una API, cómo viaja la información en formato JSON y por qué este mecanismo es la base de toda la web moderna, incluidas las herramientas de inteligencia artificial.
Qué es una API y por qué se le llama contrato entre sistemas
Una API es el mecanismo que permite que dos sistemas se hablen entre sí cuando el dato vive en un lugar y la pregunta viene de otro. La sigla viene del inglés Application Programming Interface, pero lo que importa es la idea de fondo: una API es un contrato entre dos sistemas.
Ese contrato funciona así: el servidor publica una lista de cosas que el cliente puede preguntar, cada una con un formato específico. El cliente cumple las reglas, envía su pregunta a una dirección parecida a una URL, y el servidor responde.
Imagina que Okini, una cafetería ficticia, tuviera una API real. Podrías hacerle preguntas como:
- ¿Cuántas tazas de B60 quedan disponibles hoy?
- ¿Hay cupos en la cata del sábado?
- ¿A qué hora está abierto Okini hoy?
Cada pregunta llega a una dirección concreta, el servidor consulta su base de datos, cuenta lo que tenga que contar y devuelve una respuesta.
¿Qué es una API en palabras simples? Es un acuerdo entre dos sistemas que dice: si tú me pides algo de esta forma, yo te respondo con esto otro. El cliente pregunta, el servidor responde.
Cómo se ven las respuestas: el formato JSON
Las respuestas no llegan en español ni en cualquier formato libre. Llegan en JSON, un formato diseñado para que tanto humanos como máquinas lo lean sin ambigüedad [02:30].
Una respuesta de la API hipotética de Okini se vería con tres líneas: el nombre del método, cuántas tazas quedan y el precio. Cada dato tiene una etiqueta entre comillas, dos puntos y el valor.
Y aquí viene lo interesante: si miras un JSON con atención, se parece muchísimo a las variables que ya viste antes en JavaScript. No es casualidad, JSON está basado en la sintaxis de objetos de JavaScript. Si entiendes uno, entiendes el otro casi sin esfuerzo extra.
Por qué JSON aparece en todos lados
JSON no es un detalle técnico aislado, es el lenguaje común con el que los sistemas modernos se hablan entre sí.
- Cuando una página guarda tu sesión, la guarda en JSON.
- Cuando un servidor le responde a otro, le responde en JSON.
- Cuando le pides algo a Claude o a la API de OpenAI, la respuesta llega en JSON.
Aprender a leer JSON es aprender a leer datos estructurados, y los datos estructurados son lo que viaja entre sistemas todo el tiempo.
Cómo pide el cliente: la herramienta fetch
Falta una pieza: cómo hace el cliente para enviar la pregunta. Desde JavaScript existe una herramienta llamada fetch, que básicamente le dice al navegador: ve a esta dirección, hazle esta pregunta al servidor que está allá y tráeme lo que responda [04:10].
Cuando la inteligencia artificial te genere código que consulta una API, fetch es lo que vas a ver. Ahora, cuando aparezca, sabes que el cliente le está pidiendo algo al servidor.
Una API real funcionando: el clima de Bogotá
Para que esto deje de ser hipotético, abre cualquier página web normal en tu navegador. Importante: hazlo desde una página web cargada, no en una pestaña vacía, porque las pestañas vacías tienen restricciones de seguridad que bloquean este tipo de pruebas.
Abre la consola de las dev tools y pídele al servidor de Open Meteo, una API pública del clima, que te devuelva la temperatura actual de Bogotá. Si tu navegador no te deja pegar en la consola, corre primero el comando allow pasting.
Al dar enter, en unos segundos la consola devuelve un objeto JSON con datos del clima de Bogotá: la temperatura en grados Celsius, la velocidad del viento en kilómetros por hora, la dirección del viento y la elevación de la ciudad [05:20].
Si hicieras la misma petición dentro de una hora, los números serían distintos porque el servidor reporta lo que está pasando en tiempo real. Esa misma API la pueden consultar miles de aplicaciones al tiempo, y a cada una le responde igual. El servidor no sabe ni le importa quién está preguntando, cumple su parte del contrato.
Cómo se conectan las APIs con la inteligencia artificial
Las herramientas de inteligencia artificial que has estado usando, Claude, ChatGPT, Gemini, todas se consumen a través de APIs.
Cuando una aplicación usa inteligencia artificial por dentro, lo que pasa técnicamente es esto: la aplicación envía una petición a la API del modelo, manda tu prompt como parte de la pregunta y el servidor devuelve la respuesta en formato JSON. Esa respuesta se procesa y se te muestra como texto bonito, pero por debajo es un JSON viajando por Internet.
¿Cómo funciona una API de inteligencia artificial? La aplicación manda tu prompt al servidor del modelo a través de una petición, el modelo procesa la pregunta y devuelve la respuesta como JSON. Es el mismo mecanismo que cualquier otra API.
Esto importa porque significa que las herramientas de IA no son un mundo aparte. Son un caso particular de lo mismo: cliente, servidor, API y JSON, el modelo que está debajo de cómo se mueve la información en toda la web moderna.
El mapa completo del módulo
Empezamos preguntando dónde vive lo que construyes, y la respuesta tiene cuatro capas:
- Vive en una conversación entre dos computadores que se reconocen por nombre y dirección.
- El código corre en dos lugares con responsabilidades distintas: cliente y servidor.
- Los datos pueden vivir en uno de tres sitios según lo que necesiten.
- Los sistemas se hablan a través de contratos que llamamos APIs.
Lo que sigue es llevar lo que construiste al mundo real: subir tu código a Internet, publicar tu sitio en una URL real y cerrar el círculo completo.
Un reto extra: la API más inútil del mundo
Si llegaste hasta acá, te felicito. Como recompensa, existe una API pública llamada Useless Facts cuyo único propósito es devolver datos completamente inútiles. Hazle un fetch desde la consola, igual que con la del clima, pero cambiando la URL.
Vas a ver respuestas de quienes llegaron antes y vas a dejar la tuya para quienes vienen después. Cuéntame en los comentarios qué dato inútil te tocó.
