Rest API ¿Qué es?

Si trabajas con tecnología, marketing digital o productos, probablemente hayas escuchado el acrónimo REST API. Es la columna vertebral de la Internet moderna. Así es como Instagram habla con el servidor, cómo el sitio web de viajes busca billetes de varias aerolíneas y cómo su banco aprueba una compra con tarjeta.

Pero ¿qué es exactamente DESCANSO? ¿Y por qué se ha convertido en el estándar mundial?

En este artículo, desmitificaremos el concepto técnico y explicaremos claramente qué es una API RESTful.

¿Qué significa el acrónimo?

REST significa Transferencia estatal representativa. Fue un concepto creado por Roy Fielding en su tesis doctoral en el año 2000.

No es software ni una biblioteca. Es un estilo de arquitectura. Es un conjunto de reglas y restricciones que, si se siguen, permiten que diferentes sistemas se comuniquen entre sí de forma eficiente, escalable y sencilla a través de Internet.

Una API que sigue las reglas REST se llama RESTful.

Cómo funciona (la analogía de la Web)

REST funciona igual que la navegación web que ya conoces. Cuando accede a un sitio web, usted (Cliente) solicita una página del Servidor. El Servidor le brinda una "Representación" de ese recurso (el HTML de la página).

En la API REST es lo mismo, pero en lugar de HTML (para que lo lean los humanos), usamos JSON (para que lo lean las máquinas).

Verbos HTTP (acciones)

REST utiliza métodos de protocolo HTTP estándar para definir lo que desea hacer con los datos:

OBTENER: Obtener datos. (Ej: GET /usuarios -> Dame la lista de usuarios).
POST: Crear datos. (Ej: POST /usuarios -> Crear este nuevo usuario).
PUT: Actualizar datos completos. (Ej: PUT /usuarios/1 -> Reemplazar usuario 1 con este dato).
ELIMINAR: Eliminar datos. (Ej: DELETE /usuarios/1 -> Eliminar usuario 1).

Esto es intuitivo. Antes de REST, usábamos protocolos complejos (como SOAP) en los que había que inventar nombres para todo (getUserList, createNewUserXml). En REST, la URL es el sustantivo (/usuarios) y el método HTTP es el verbo (GET, POST).

Apátrida

Esta es la regla más importante. El servidor no almacena memoria de su navegación anterior. Cada solicitud (solicitud) debe contener TODA la información necesaria para ser procesada (como quién es usted, el token de autenticación, qué desea). Esto permite que la API sea muy rápida y escalable, ya que el servidor no desperdicia memoria almacenando "sesiones".

La anatomía de una llamada REST

Imagina que quieres saber la temperatura de hoy.

Punto final (URL): https://api.clima.com/v1/previsao
Método: GET
Encabezado: Authorization: Bearer 12345 (Tu cédula de identidad).
Cuerpo: (Vacío en GET, pero en POST contendría datos).

Respuesta del servidor: el servidor devuelve un JSON simple con el estado de la operación ("éxito") y los datos solicitados, por ejemplo, temperatura de 22 grados centígrados para la ciudad de Curitiba. Es un paquete liviano, legible en cualquier idioma, que la aplicación solo necesita interpretar y mostrar en pantalla.

¿Por qué ganó REST?

¿Por qué no utilizamos otras formas?

Simplicidad: utiliza el protocolo HTTP que ya existe en todas partes. Cualquier navegador o lenguaje de programación entiende HTTP.
Separación Cliente-Servidor: La aplicación (frontend) y el servidor (backend) son completamente independientes. Puedes cambiar el diseño de la aplicación sin dañar el servidor y viceversa, siempre que el formato JSON siga siendo el mismo.
Caché: REST aprovecha el almacenamiento en caché web. Si haces un GET /produtos, el navegador o la red pueden guardar esa respuesta durante unos minutos, guardando datos.

Conclusión

REST API es la lengua franca de Internet. Comprender sus principios (Recursos, Verbos HTTP, Stateless) es fundamental para cualquier profesional de la tecnología.

Aunque tecnologías más nuevas como GraphQL y gRPC están ganando terreno para casos específicos, REST sigue siendo el estándar de oro para el 90 % de las integraciones web debido a su simplicidad y solidez universal.