Hypermedia-driven REST API

본 글은 REST API 설계의 중요한 원칙 중 하나인 Hypermedia-driven REST API, 즉 HATEOAS(Hypermedia as the Engine of Application State)에 대해 설명합니다. HATEOAS는 API 클라이언트가 서버로부터 받은 리소스 표현 내에 포함된 링크를 통해 다음 상태 전이를 탐색할 수 있도록 하는 아키텍처 스타일입니다.

이를 통해 API의 결합도를 낮추고, 클라이언트의 유연성을 높이며, API의 진화와 유지보수를 용이하게 합니다. 글에서는 HATEOAS를 구현하기 위한 여러 방법론, 특히 HAL(Hypertext Application Language)과 JSON:API를 소개하고 각 형식의 특징과 장단점을 비교합니다.

또한, HATEOAS를 적용함으로써 얻을 수 있는 이점과 실제 API 설계 시 고려해야 할 사항들을 제시하며, Hypermedia가 RESTful API의 완성도를 높이는 핵심 요소임을 강조합니다.