cómo Qué es una API

Una pantalla para personas, una ventanilla para apps

Antes aprendimos que al enviar una petición,
vuelve una respuesta.
La respuesta que recibe una persona suele ser una página web.
Tiene texto, imágenes y botones.
Linda para el ojo humano,
pero demasiado enredada para que una app la use.
Por eso, entre apps, en vez de una pantalla,
intercambian datos que pueden usar de inmediato.
Esa ventanilla acordada se llama API.

Toca la pantalla para personas y la ventanilla para apps para comparar. ¿Cuál le sirve mejor a una app?

La misma información puede verse distinta.
A las personas les da una pantalla arreglada para verse bien,
a las apps les da datos sin nada de relleno.
La pantalla está hecha para que la lea una persona,
la ventanilla está hecha para que la lea una app.
Entonces, ¿cómo le habla una app
a esa ventanilla?
A continuación vemos cómo hacer una petición.

Pedir en un formato fijo

No puedes decirle cualquier cosa a la ventanilla.
Debes preguntar en el formato fijado de antemano.
Por ejemplo, una petición acordada como
"dime el clima de Seul."
Es como leer un menú en un restaurante
y pedir por los nombres establecidos.
Cuando el pedido es la frase acordada,
la cocina lo hace al instante sin confundirse.
Una API también entiende solo peticiones acordadas.

Toca una petición acordada para enviarla a la API. Al ser un formato fijo, la ventanilla entiende enseguida.

Ya enviada la petición,
es hora de una respuesta.
En vez de una pantalla enviada a una persona,
¿con qué responde la API?
Para que una app la use de inmediato,
responde con datos ordenados con prolijidad.
Cómo se ven esos datos
lo desplegamos en el siguiente paso.

Responde con datos, no con una imagen

La respuesta de una API no es una imagen.
Es un dato donde los nombres van con valores.
Por ejemplo temperatura es 23,
cielo es despejado, así.
El nombre deja claro qué es cada valor.
Esta forma de escribir nombres con valores
se suele llamar JSON.
La app elige solo los valores que necesita
de este dato y los usa en su propia pantalla.

Toca para desplegar el dato. No una imagen sino nombres y valores limpios (temperatura 23, soleado).

Como cada valor tiene un nombre,
la app no se confunde.
Si necesita la temperatura, toma la temperatura,
si necesita el clima, toma el clima.
Una imagen habría que descifrarla,
pero un dato se usa de inmediato.
Y no hay solo una ventanilla así.
Una de clima, una de mapa, hay muchas.
Entonces, ¿qué pasa si combinamos dos o más?

Combinar ventanillas para crear un nuevo servicio

Cada ventanilla hace solo una cosa.
La ventanilla de mapa te dice la ubicación,
la de clima te dice el clima.
Pero, ¿y si juntamos las dos?
Aparece un nuevo servicio que muestra
el clima de un lugar justo sobre el mapa.
Como encajar bloques,
reunimos varias ventanillas para hacer algo más grande.
Las apps que usamos se hacen así.

Toca la API de mapa y la API de clima por turnos para combinarlas. Unidas, hacen un nuevo servicio que muestra el clima en el mapa.

Cuando los datos de las dos ventanillas se encontraron,
apareció algo que ninguna podía sola.
No hace falta construir mapa ni clima desde cero,
solo tomamos prestadas ventanillas existentes y las unimos.
Así un nuevo servicio se hace rápido.
En vez de tallar la rueda otra vez,
tomamos piezas bien hechas y las usamos.
Así cambió el mundo la API.

Resumamos

Reunido en una línea, es esto.
Las personas miran pantallas, pero las apps intercambian datos.
Esa ventanilla acordada es la API.
Pide en un formato fijo
y responde con datos de nombres y valores, no una imagen.
Combina varias ventanillas y aparece un nuevo servicio.
Así no hay que construir todo desde cero,
podemos tomar prestadas ventanillas existentes para hacer cosas nuevas.

Toca los puntos clave en orden para repasar. (ventanilla para apps → pedir en formato fijo → responder con datos → combinar en un nuevo servicio)

Ahora sabes cómo las apps
intercambian datos entre sí.
Detrás de una app que puedes ver,
muchas ventanillas trabajan en silencio.
La próxima vez que abras una app del clima,
piénsalo un momento.
¿De qué ventanilla
sacó esa pantalla sus datos?,
podrías preguntarte.