HATEOAS Principles - JulianeMaran32/Java-with-Spring-Boot GitHub Wiki

Explicação Simples sobre HATEOAS

HATEOAS é um princípio usado em APIs REST que ajuda a torná-las mais fáceis de usar e descobrir. O nome vem do inglês: Hypermedia as the Engine of Application State.

Isso significa que, quando você pede informações a uma API, ela não apenas te devolve os dados, mas também diz o que você pode fazer a seguir. É como um site com links: você entra em uma página e vê links para outras páginas relacionadas.

Exemplo Simples

Imagine que você está usando um aplicativo de pedidos de comida e pede informações sobre um pedido que já fez. Uma API comum poderia te devolver algo assim:

{
  "pedidoId": 123,
  "status": "em preparo"
}

Mas uma API que segue HATEOAS enviaria algo assim:

{
  "pedidoId": 123,
  "status": "em preparo",
  "_links": {
    "cancelar": { "href": "/pedidos/123/cancelar" },
    "acompanhar": { "href": "/pedidos/123/rastreamento" }
  }
}

Veja que agora a resposta te diz quais ações você pode tomar a seguir: cancelar ou acompanhar o pedido. Assim, o cliente da API não precisa "adivinhar" quais ações estão disponíveis, porque a própria API fornece os próximos passos.

🔙 Voltar ao Início

📌 Sobre esta Wiki

Esta Wiki faz parte do repositório Java with Spring Boot e tem como objetivo documentar os principais conceitos e práticas abordadas no curso Spring Boot 3, Spring 6 & Hibernate for Beginners.

Se você encontrar algum erro ou desejar contribuir, confira as orientações abaixo.

🔗 Links Úteis

🤝 Contribuições

Contribuições são bem-vindas! Se deseja sugerir melhorias ou corrigir erros, siga os passos:

  1. Verifique se sua sugestão já não está em uma Issue aberta.
  2. Crie um Fork do repositório e faça as alterações.
  3. Envie um Pull Request explicando suas mudanças.

⚖️ Licença

Este projeto está licenciado sob a Apache License.

📞 Contato

💡 Créditos

Este projeto foi inspirado pelo curso "[NEW] Spring Boot 3, Spring 6 & Hibernate for Beginners" disponível na plataforma Udemy.

🔄 Última Atualização

📅 Última atualização: 02/04/2025

🔖 Versão

Versão Atual: 1.0.0.

⚠️ **GitHub.com Fallback** ⚠️