El Proyecto | Sobre nosotros | Contribuir | Donaciones | Licencia

HOME

Introducción

REST (Representational State Transfer) es un estilo arquitectónico para diseñar servicios web. Fue introducido por Roy Fielding en su tesis doctoral en el año 2000. REST se basa en un conjunto de principios que permiten la creación de sistemas distribuidos escalables y eficientes. En esta sección, exploraremos los principios básicos de REST y cómo se aplican en el diseño de APIs RESTful.

Principios de REST

Cliente-Servidor

El principio de cliente-servidor establece una separación clara entre el cliente y el servidor. El cliente es responsable de la interfaz de usuario y la experiencia del usuario, mientras que el servidor maneja la lógica de negocio y el almacenamiento de datos. Esta separación permite que ambos componentes evolucionen de manera independiente.

Interfaz Uniforme

Una interfaz uniforme simplifica y desacopla la arquitectura, lo que permite que cada parte del sistema evolucione de manera independiente. Los elementos clave de una interfaz uniforme son:

Identificación de recursos: Los recursos se identifican mediante URIs (Uniform Resource Identifiers).
Manipulación de recursos a través de representaciones: Los clientes interactúan con los recursos mediante representaciones (por ejemplo, JSON, XML).
Mensajes autodescriptivos: Cada mensaje incluye suficiente información para describir cómo procesarlo.
Hipermedios como el motor del estado de la aplicación (HATEOAS): Los clientes descubren las acciones disponibles a través de hipervínculos proporcionados en las respuestas.

Sin estado

Cada solicitud del cliente al servidor debe contener toda la información necesaria para entender y procesar la solicitud. El servidor no debe almacenar ningún estado del cliente entre las solicitudes. Esto simplifica el diseño del servidor y mejora la escalabilidad.

Cacheabilidad

Las respuestas deben ser explícitamente etiquetadas como cacheables o no cacheables. Si una respuesta es cacheable, el cliente puede reutilizar la respuesta en solicitudes futuras, lo que reduce la carga en el servidor y mejora el rendimiento.

Sistema en capas

Una arquitectura REST puede estar compuesta por múltiples capas, cada una con una funcionalidad específica. Las capas pueden incluir servidores de seguridad, balanceadores de carga, servidores de aplicaciones, etc. Esta estructura en capas mejora la escalabilidad y la seguridad del sistema.

Código bajo demanda (opcional)

Los servidores pueden proporcionar código ejecutable al cliente, como scripts JavaScript. Este principio es opcional y no es necesario para todas las arquitecturas REST.

Ejemplo Práctico

Para ilustrar estos principios, consideremos una API RESTful para gestionar una biblioteca de libros.

Identificación de recursos

Cada libro en la biblioteca se identifica mediante un URI único. Por ejemplo:

GET /books/1

Manipulación de recursos a través de representaciones

El cliente puede obtener una representación de un libro en formato JSON:

{
  "id": 1,
  "title": "El Quijote",
  "author": "Miguel de Cervantes",
  "published_year": 1605
}

Mensajes autodescriptivos

Una solicitud para crear un nuevo libro incluye toda la información necesaria:

POST /books
Content-Type: application/json

{
  "title": "Cien Años de Soledad",
  "author": "Gabriel García Márquez",
  "published_year": 1967
}

Hipermedios como el motor del estado de la aplicación (HATEOAS)

La respuesta a una solicitud de un libro puede incluir enlaces a acciones relacionadas:

{
  "id": 1,
  "title": "El Quijote",
  "author": "Miguel de Cervantes",
  "published_year": 1605,
  "links": [
    {
      "rel": "self",
      "href": "/books/1"
    },
    {
      "rel": "update",
      "href": "/books/1"
    },
    {
      "rel": "delete",
      "href": "/books/1"
    }
  ]
}

Ejercicio Práctico

Ejercicio 1: Identificación de Recursos

Dado el siguiente conjunto de recursos, escribe los URIs correspondientes:

Un usuario con ID 123.
La lista de todos los libros.
Un autor con ID 456.

Solución:

/users/123
/books
/authors/456

Ejercicio 2: Mensajes Autodescriptivos

Escribe una solicitud HTTP para actualizar la información de un libro con ID 2. El título debe ser "1984" y el autor "George Orwell".

Solución:

PUT /books/2
Content-Type: application/json

{
  "title": "1984",
  "author": "George Orwell"
}

Conclusión

En esta sección, hemos cubierto los principios básicos de REST, incluyendo la separación cliente-servidor, la interfaz uniforme, la naturaleza sin estado, la cacheabilidad, el sistema en capas y el código bajo demanda. Estos principios son fundamentales para diseñar APIs RESTful eficientes y escalables. En la próxima sección, exploraremos cómo aplicar estos principios en el diseño de APIs RESTful.

Principios básicos de REST