01 Introduction To Hateoas

title: Introduction to HATEOAS and Hypermedia APIs weight: 11 date: 2026-06-28 lastmod: 2026-06-28 description: Learn HATEOAS (Hypermedia as the Engine of Application State) — the most advanced REST constraint enabling self-discoverable APIs through hypermedia links. tags: [api-development, hateoas]

HATEOAS (Hypermedia as the Engine of Application State) is a REST constraint where API responses include hypermedia links that guide clients to discover available actions and related resources dynamically without prior endpoint knowledge.

```mermaid
flowchart LR
  A[Client] -->|GET /orders/5| B[Server]
  B --> C[Order + Links]
  C --> D[self, cancel, invoice]
  D -->|Client follows cancel| E[POST /orders/5/cancel]
  style A fill:#e1f5fe
  style B fill:#f3e5f5
  style C fill:#c8e6c9

HATEOAS responses include link objects with rel (relationship) and href (target URI). A user response might include links to their orders, profile, update, and delete actions. Clients navigate the API by following links rather than constructing URLs from documentation.

Think of HATEOAS like a website versus a printed API reference. A website has clickable links that guide you to related pages. A printed reference requires you to type URLs manually. HATEOAS makes APIs self-documenting and navigable.

What's Next

Now learn about the REST constraint HATEOAS in Hypermedia APIs and HATEOAS.