Guías

Una API REST es la forma más habitual de que un software hable con otro a través de la web. REST significa REpresentational State Transfer (transferencia de estado representacional): un conjunto de convenciones para pedir y modificar datos usando los métodos web (HTTP) de toda la vida. Cada vez que una app carga tu perfil o publica un comentario, casi con seguridad está llamando a una API REST entre bastidores.

Cómo funciona una API REST

La idea central es sencilla: todo es un «recurso» con su propia URL, y actúas sobre él con verbos HTTP estándar. GET lee datos, POST los crea, PUT o PATCH los actualiza, y DELETE los elimina. Pide GET /users/42 y obtienes el usuario 42; envía DELETE /users/42 y ese usuario desaparece.

El servidor responde con datos, casi siempre en formato JSON: ligero y legible para humanos. Cada respuesta lleva además un código de estado, como 200 OK, 404 Not Found o 401 Unauthorized, que le dice a tu app exactamente qué ha pasado para que pueda reaccionar correctamente.

Por qué los desarrolladores usan REST

REST es también «sin estado» (stateless): cada petición lleva todo lo que el servidor necesita, y el servidor no guarda memoria de las llamadas anteriores. Eso hace que las API REST sean fáciles de escalar, porque cualquier servidor puede atender cualquier petición, lo cual es una de las grandes razones por las que este estilo se convirtió en el estándar de toda la web.

• Permite que un software hable con otro a través de HTTP
• Los recursos tienen URLs; los verbos son GET, POST, PUT, DELETE
• Las respuestas suelen ser JSON con un código de estado
• Sin estado (stateless): cada petición se basta a sí misma, así que escala
• Protegida con tokens (clave de API o JWT) sobre HTTPS

Para quien desarrolla front-end, REST es el pan de cada día. Tu app de Vue, React o JavaScript puro carga datos desde endpoints REST (con fetch o una librería como axios), los muestra en la página y envía los cambios de vuelta. La API es el contrato entre tu interfaz y los datos que viven detrás de ella.

REST vs GraphQL

REST no es la única opción. GraphQL permite al cliente pedir exactamente los campos que quiere en una sola petición, lo que puede reducir el exceso de datos descargados. Pero la sencillez de REST, su caché fácil y su pura ubicuidad lo mantienen como el estilo de API más usado con diferencia.

Seguridad y buen diseño

Las API reales necesitan control de acceso. La mayoría envían un token —una clave de API o un JWT— en una cabecera de la petición, y funcionan sobre HTTPS para que los datos no puedan leerse en tránsito. Las API bien gestionadas también versionan sus endpoints (/v1/, /v2/) para que los cambios no rompan de golpe las apps que ya las usan.

Una API REST bien diseñada es predecible: URLs de recurso claras, los verbos HTTP y códigos de estado correctos, JSON coherente y mensajes de error útiles. Esa predecibilidad es lo que permite que un front-end y un back-end los construyan personas distintas y aun así encajen a la perfección.

Dónde se ejecuta una API REST

Por último, una API REST tiene que ejecutarse en algún sitio. Tu front-end puede ser archivos estáticos servidos desde un CDN, pero la API en sí necesita un servidor real, siempre disponible, para atender las peticiones y llegar a tu base de datos. En resumen: una API REST es el contrato estándar de la web para mover datos entre programas —sencillo, sin estado, JSON sobre HTTP— y un servidor fiable es lo que la mantiene respondiendo.