Saltar al contenido

Módulo 0Cómo funciona todo esto · Lección gratis

Qué es una API

  • 7 min de lectura
  • 7 apartados
  • 5 ejercicios

La palabra API aparece en todas partes. La verás en webs de herramientas, en ofertas de trabajo y en cualquier conversación sobre IA. En esta lección entenderás qué es con un ejemplo de restaurante. Después verás tres casos reales que usas casi a diario.

Qué es una API

API son las siglas en inglés de Application Programming Interface (interfaz de programación de aplicaciones). El nombre asusta, pero la idea es sencilla. Una API es una forma acordada para que dos programas se hablen. Un programa pide algo. El otro se lo da.

El camarero del restaurante

Piensa en un restaurante. Tú eres el cliente. No entras en la cocina. Le das el pedido al camarero. El camarero lo lleva a la cocina. Después te trae el plato.

En esta comparación, el camarero es la API. La cocina es el otro programa. El plato es la respuesta.

Tú no necesitas saber cómo se cocina. La cocina no necesita salir a la sala. El camarero hace de puente entre los dos.

Además, solo puedes pedir lo que está en la carta. Una API también tiene su carta. Es la lista de cosas que se le pueden pedir y cómo pedirlas. Se llama documentación.

Dos filas. Arriba, en un restaurante, el cliente da el pedido al camarero, que lo lleva a la cocina, y el plato vuelve por el mismo camino. Abajo, entre programas, tu app envía una petición a la API, que la pasa al servidor, y la respuesta vuelve igual. El camarero y la API aparecen destacados.

Petición y respuesta

Lo que un programa pide se llama petición (en inglés, request). Lo que recibe se llama respuesta (response). La petición indica qué quieres y con qué datos. La respuesta trae el resultado.

Petición
Dame el tiempo de Sevilla para mañana

Respuesta
{ "ciudad": "Sevilla", "maxima": 27, "cielo": "despejado" }

La respuesta de arriba está en JSON. Es un formato de texto que usan muchas APIs para enviar datos. Cada dato tiene un nombre y un valor. Se lee bastante bien aunque no sepas programar.

Tres ejemplos reales

El tiempo en el móvil

La app del tiempo de tu móvil no tiene estaciones meteorológicas propias. Cuando la abres, envía una petición a la API de un servicio meteorológico. Le dice dónde estás. La API le devuelve la temperatura y la previsión. La app solo se encarga de enseñártelo bonito.

Pagar con tarjeta en una web

Así la tienda no tiene que montar su propio sistema de cobros. Y tampoco tiene que guardar los datos de tu tarjeta.

Iniciar sesión con Google

Muchas webs tienen un botón que dice «Continuar con Google». Al pulsarlo, la web pregunta a Google por su API quién eres. Google te pide permiso. Si aceptas, le confirma a la web tu nombre y tu correo. La web nunca ve tu contraseña de Google.

La clave de la API

Muchas APIs piden una clave de API (en inglés, API key). Es un código largo que identifica quién hace la petición. Sirve para controlar quién entra. También sirve para cobrar según el uso. Por ejemplo, las APIs de ChatGPT o de Claude cobran por cada petición que haces.

Por qué te importa

Las herramientas de IA también tienen API. Muchas empresas conectan ChatGPT o Claude con sus propios programas a través de ella. Lo verás en los módulos 3 y 4. A partir de ahora, cuando alguien diga «eso se conecta por API», sabrás qué quiere decir.

Palabras clave

  • API: forma acordada para que dos programas se pidan cosas y se respondan.
  • petición (request): lo que un programa pide a otro a través de una API.
  • respuesta (response): lo que devuelve la API después de una petición.
  • documentación: la «carta» de una API, con lo que se le puede pedir y cómo.
  • JSON: formato de texto con nombres y valores que usan muchas APIs para enviar datos.
  • clave de API (API key): código secreto que identifica quién usa una API.