Fundamentos de API: El Mesero del Restaurante

Objetivo del Módulo

Desmitificar el acrónimo más usado en todo Silicon Valley: API (Application Programming Interface).

Aprender a hackear páginas web usando tu navegador web (Google Chrome) y darle clic a los botones es hacking de nivel amateur. Hoy en día, el 80% del tráfico de internet ocurre sin interfaz gráfica. Son servidores hablando con otros servidores de forma invisible. Si quieres encontrar los peores agujeros de seguridad en el internet moderno, tienes que hackear a la API.

---

1. La Analogía: El Mesero

Imagina que entras a un restaurante de lujo.

• Tú (El Cliente / La App Móvil): Tienes hambre y quieres comer.
• La Cocina (La Base de Datos): Está llena de la comida (los datos) que tú quieres.

El Problema: El dueño del restaurante no te permite entrar físicamente a la cocina. Si todos los clientes entraran a la cocina a agarrar comida, harían un desastre, se quemarían con las estufas y se robarían la comida de otros.

La Solución (La API): Para que puedas conseguir tu comida sin pisar la cocina, el restaurante contrató a un Mesero (La API).

1. La Petición (Request): Tú le das al mesero un papelito (Tu orden) que dice: "Quiero la hamburguesa número 5".
2. El Transporte: El mesero camina hasta la cocina blindada, entrega el papelito y el cocinero hace la hamburguesa.
3. La Respuesta (Response): El mesero sale de la cocina con un plato en la mano y te entrega exactamente la hamburguesa 5 en tu mesa. No viste cómo la prepararon, no viste la cocina, solo recibiste el resultado.

En la vida real: Cuando abres la App de Uber en tu celular y pides un auto, tu celular no tiene todo el mapa mundial guardado adentro. Tu celular es el Cliente en la mesa. Envía una Petición (Request) a la API de Google Maps (El Mesero). La API va a los servidores gigantescos de Google (La Cocina), saca el mapa de tu calle, y se lo trae a tu celular para que lo dibuje en tu pantalla.

---

2. El Lenguaje de las Máquinas: JSON

Cuando las máquinas (El Cliente y El Mesero) hablan entre sí, no usan Español ni Inglés. Usan un formato de texto estructurado y ligero para pasarse los datos súper rápido. El formato rey del internet moderno se llama JSON (JavaScript Object Notation).

Es literalmente texto plano organizado con llaves {}.

Un "papelito de orden" (API Request) pidiendo información de un usuario se ve así:

{
  "usuario_id": 15,
  "accion": "leer_perfil"
}

La "bandeja con comida" (API Response) que el mesero te trae de regreso se ve así:

{
  "nombre": "Juan Perez",
  "saldo_bancario": 5000.00,
  "tarjeta": "terminacion 4455"
}

El Hacker de APIs

Un Hacker de élite ignora la bonita página web del banco. No le importa si el botón de "Transferir" es azul o verde. El Hacker abre una terminal de comandos, intercepta el papelito (JSON) antes de que llegue al mesero, le cambia el número mágico (Ej. cambia "saldo": 100 a "saldo": 1000000), y se lo entrega directamente a la API a espaldas del desarrollador.

---

3. Criterio de Dominio (Autoevaluación)

Revisa si entiendes la arquitectura moderna de internet:

1. Usando la analogía del "Mesero y la Cocina", explica por qué la arquitectura de Software como Servicio (SaaS) separa estrictamente la Aplicación del Celular (Frontend) de los Servidores de Base de Datos (Backend) y obliga a que toda comunicación pase por una API.
2. Un desarrollador junior afirma que su página web es segura "porque escondió el botón rojo de Borrar Cuenta usando código CSS para que sea invisible en la pantalla del usuario". ¿Por qué un Hacker de APIs se reiría de esta "medida de seguridad" y cómo lograría borrar la cuenta de todas formas?
3. ¿Qué es JSON y por qué desplazó al antiguo formato XML como el lenguaje dominante para la comunicación entre APIs RESTful modernas?
4. Si analizas el tráfico de red de tu computadora mientras juegas un videojuego multijugador masivo en línea, verás miles de paquetes JSON volando por segundo. ¿Quién es el "Cliente" y quién es el "Mesero" en este escenario interactivo?