From the course: Building and Securing RESTful APIs in ASP.NET Core

Unlock the full course today

Join today to access over 22,600 courses taught by industry experts or purchase this course individually.

Self-documentation and HATEOAS

Self-documentation and HATEOAS - ASP.NET Core Tutorial

From the course: Building and Securing RESTful APIs in ASP.NET Core

Start my 1-month free trial

Self-documentation and HATEOAS

- [Instructor] We've talked about how RESTful APIs represent resources and links between resources. There's one other big piece to the RESTful puzzle, though, and it's one of the distinguishing features of REST. That feature is HATEOAS, or Hypermedia as the Engine of Application State. Let's unpack what this means. The big idea of HATEOAS is that the responses from the API tell the client what it can do in the API. Here's how that works, when the client retrieves a resource, the response not only includes the details of the resource, but also a set of links that the client can use to either get additional information or change some state in the application. For example, a response that represents a room in the hotel could have links that the client could follow to view all the bookings for that room, create a new booking by sending a post request, or delete the room by sending a delete request. Let's imagine that the ability to delete an entire room was something that only an…

Contents