¿Qué es una API REST?

API REST: definición y origen

REST no es un protocolo ni un software, sino un estilo de arquitectura. Lo describió el informático Roy Fielding en el año 2000 en su tesis doctoral. Una interfaz que aplica estos principios se denomina API REST o API RESTful.

En el centro están los recursos, es decir, elementos como clientes, pedidos o productos. Cada recurso tiene su propia dirección (URL), por ejemplo /api/clientes/42. Como REST se basa en el conocido protocolo web HTTP, puede utilizarse con prácticamente cualquier lenguaje de programación.

Cómo funciona una API REST

Un cliente envía una solicitud HTTP a una URL e indica con el método qué debe ocurrir. El servidor responde con los datos y un código de estado que describe el resultado, por ejemplo 200 para «correcto» o 404 para «no encontrado».

Un aspecto clave es la ausencia de estado: entre dos solicitudes, el servidor no guarda nada sobre el cliente. Cada solicitud incluye toda la información necesaria. Esto hace que las API REST sean muy escalables, ya que cualquier servidor puede responder a cualquier solicitud.

• GET: consultar datos, p. ej., una lista de clientes
• POST: crear un registro nuevo, p. ej., un pedido
• PUT / PATCH: modificar datos existentes total o parcialmente
• DELETE: eliminar un registro

Ventajas y límites de REST

Las API REST son fáciles de entender, se documentan bien —por ejemplo, con el estándar OpenAPI— y pueden utilizarlas por igual navegadores, apps y servidores. Las respuestas pueden almacenarse en caché, lo que reduce la carga y acorta los tiempos de carga.

Los límites aparecen en las consultas de datos complejas: a menudo se necesitan varias solicitudes o se entregan más datos de los necesarios. En esos casos, GraphQL puede ser la mejor opción y, para una comunicación interna muy rápida entre servicios, también gRPC.

• Muy extendido: muchas herramientas y desarrolladores conocen este estilo
• URL claras y legibles y métodos HTTP estandarizados
• Fácil de almacenar en caché y escalable horizontalmente
• Con datos anidados, a veces se necesitan muchas solicitudes individuales

Ejemplo práctico: una API REST para app y sitio web

Una empresa de oficios encarga una plataforma para sus clientes: los clientes reservan citas en el sitio web y los montadores ven sus trabajos asignados en una app. Ambos acceden al backend a través de la misma API REST. Más adelante pueden conectarse nuevos canales —por ejemplo, un portal de clientes— sin duplicar la lógica de negocio.

En la práctica importan un control de versiones limpio (p. ej., /api/v1/), mensajes de error comprensibles, autenticación y una limitación de solicitudes (rate limiting). Nano Concepts planifica y desarrolla API REST con su documentación, para que también su equipo o socios externos puedan trabajar con ellas.