Explica el principio de HATEOAS.

HATEOAS (Hypermedia como la Máquina de Estado de la Aplicación) es una restricción de la arquitectura REST que establece que el cliente interactúa con el servicio REST completamente a través de hipermedios proporcionados por el servidor en las respuestas.

En lugar de conocer de antemano las URI de todos los recursos y acciones, el cliente recibe esta información en forma de enlaces y formularios integrados en las representaciones de los recursos.

Aspectos clave:

• Mensajes auto-descriptivos: Cada mensaje enviado al cliente, además de los datos, contiene enlaces a recursos relacionados y acciones disponibles.
• No es necesario conocer las URI de antemano: El cliente sigue los hipermedios para navegar por la API y realizar acciones. Solo conoce el punto de acceso inicial.
• Mejora en la evolución: El servidor puede cambiar las URI de los recursos sin modificar la lógica del cliente, siempre que siga proporcionando los hipermedios correspondientes.
• Reducción del acoplamiento cliente-servidor: El cliente depende menos de la estructura interna del servidor.

Ejemplo de representación de un recurso con HATEOAS:

{
  "orderId": "123",
  "status": "Pending",
  "items": [
    {
      "itemId": "A45",
      "quantity": 2
    }
  ],
  "_links": {
    "self": {
      "href": "/orders/123"
    },
    "cancel": {
      "href": "/orders/123/cancel",
      "method": "POST" // Indica el tipo de acción
    },
    "customer": {
      "href": "/customers/C99"
    }
  }
}

Aquí, _links contiene URIs para el propio recurso, la posibilidad de cancelar el pedido y el cliente relacionado. El cliente, al recibir esta representación, sabe cómo realizar estas acciones sin tener sus URI "codificados" en su código.

Aunque HATEOAS es un principio clave de REST, su aplicación completa y coherente puede ser difícil en la práctica.