¿Qué es una API?

El menú de lo que un server puede hacer

⏱ Estim. ~4 min

01 · Leer

Una API (Application Programming Interface, interfaz de programación de aplicaciones) es un conjunto de reglas que define qué solicitudes acepta un server y qué respuestas devuelve.

Cuando un ingeniero hace un server, no deja que cualquiera le mande cualquier solicitud. Hace una API — una lista clara de los endpoints (URLs) que se pueden llamar, qué datos enviar y qué se obtiene de vuelta.

Cada app que usas depende de APIs. Cuando la app del clima te muestra el pronóstico, está llamando una API del clima. Cuando entras a un sitio web, está llamando una API de autenticación. Cuando haces scroll en tu feed social, está llamando una API para traer la siguiente tanda de posts.

💡 Imagínalo asíUna API es como el menú de un restaurante. El menú te dice qué puedes pedir, qué lleva cada plato y cuánto cuesta. No puedes entrar a la cocina e improvisar — eliges del menú. Una API es igual: le dice a tu app qué le puede pedir al server.

Puntos clave

API = Application Programming Interface
Define el "menú" de solicitudes que el server acepta
Cada elemento del menú se llama endpoint (un URL + method específico)
Las APIs permiten que distintos sistemas se comuniquen sin conocer los detalles internos del otro

02 · Ejemplo de código

Así se ve una API típica de un blog. Cada endpoint es la combinación de un HTTP method más una ruta de URL.

Blog API Endpoints

GET    /api/posts          → Get all blog posts
GET    /api/posts/15       → Get post #15
POST   /api/posts          → Create a new post
PUT    /api/posts/15       → Update post #15
DELETE /api/posts/15       → Delete post #15

User API Endpoints

GET    /api/users          → Get all users
GET    /api/users/42       → Get user #42's profile
POST   /api/users          → Create a new user (sign up)
PUT    /api/users/42       → Update user #42's profile
DELETE /api/users/42       → Delete user #42's account

Fíjate en el patrón: la URL te dice sobre qué estás operando (/posts o /users), el número te dice cuál, y el HTTP method te dice qué quieres hacer. Este patrón consistente hace que las APIs sean fáciles de adivinar y usar.

03 · Quiz

Una app del clima en tu celular muestra el pronóstico de hoy. ¿De dónde saca esos datos?

Los datos del pronóstico están hardcodeados dentro de la app
La app lee datos de los sensores del celular
La app llama a una API del clima y obtiene los datos más recientes
La app hace scraping de un sitio web del clima

04 · Completar

Una API define qué _____ acepta el server.

Otras lecciones de este capítulo

⚠ La experiencia interactiva completa necesita JavaScript. Actívalo y vuelve a cargar la página.

※ Este es un proyecto educativo independiente — no es un producto oficial de Anthropic. Claude™ es una marca registrada de Anthropic, PBC.