La API es el mesero, no la cocina

Ilustración vectorial de un mesero que lleva pedidos entre una aplicación y un servidor, con mensajes JSON. — Una API es el mesero entre tu app y el servicio: pide y recibe datos.

Una API es la puerta ordenada por la que una aplicación le pide cosas a otra y recibe respuestas. No es magia ni es la cocina: es el mesero que toma tu pedido, lo lleva a la cocina (el servicio) y te regresa el plato. Cuando tu app consulta el clima, cobra con tarjeta o manda un WhatsApp, no está entrando a la computadora de esas empresas. Está haciendo una petición a su API y recibiendo una respuesta.

No necesitas saber cocinar para ordenar; necesitas saber pedir. Con las APIs pasa igual.
— Idea central del curso

Por qué te importa como constructor Casi todo producto con IA se arma combinando servicios: un modelo de lenguaje, una pasarela de pago, un mapa, un mensajero. Las APIs son los cables que los unen. Entenderlas te vuelve independiente del programador.

Las piezas de una conversación con una API

Petición: tu app arma una solicitud con lo que quiere (a quién, qué, cómo).
Endpoint: la dirección concreta donde vive esa función del servicio.
Respuesta: el servicio contesta con datos, casi siempre en formato JSON.
Estado: un código te dice si salió bien o falló (y por qué).

Mapa conceptual

Misma coreografía: pedir, procesar, responder.
En el restaurante	En una API	Para qué
Vas a una mesa y pides	Llamas a un endpoint	Decir qué quieres
El mesero anota tu pedido	Envías una petición con datos	Dar la información necesaria
La cocina prepara el plato	El servicio procesa tu solicitud	Hacer el trabajo real
Te traen el plato	Recibes una respuesta JSON	Obtener el resultado

Ordena lo que ocurre cuando tu app usa la API de un servicio de clima.

☰

¿Cuál es la mejor definición de API para alguien que construye con IA?

Para que tu app consulte un servicio externo, necesita entrar y copiar los archivos de la computadora de ese servicio.

Nombra DOS cosas que tu idea de app necesitaría de un servicio externo (por ejemplo, cobrar, enviar mensajes, consultar un mapa). Esas serán tus primeras APIs.

Pista

Si tu producto necesita algo que no produce, casi seguro lo consumirá por una API.

Una API es el mesero: lleva pedidos y trae respuestas.
Todo se reduce a petición, endpoint, respuesta JSON y código de estado.
Construir con IA es, en gran parte, conectar APIs.

Siguiente paso: GET, POST y JSON — el idioma exacto en que tu app le habla a una API.