← Lessons

quiz vs the machine

Silver1100

System Design

HATEOAS and Hypermedia

Letting responses tell clients what they can do next.

4 min read · intro · beat Silver to climb

Links Drive the Client

HATEOAS means hypermedia as the engine of application state. Instead of hardcoding every URL, a client follows links embedded in each response. The server returns not just data but also the actions available right now, such as a link to cancel an order or to pay an invoice.

Why It Helps

  • Clients depend on link names rather than fixed URL strings.
  • The server can move endpoints without breaking callers.
  • Available actions reflect the current state; a paid invoice hides the pay link.

The Trade

Full HATEOAS adds response size and client complexity, so many teams adopt it partially. Even a few well named links for next steps can reduce coupling between client and server.

Key idea

Hypermedia lets the server advertise valid next actions as links, so clients navigate by relation names instead of memorizing brittle URLs.

Check yourself

Answer to earn rating on the learn ladder.

1. What does a HATEOAS response add beyond the resource data?

2. A key benefit of HATEOAS is that clients depend on what?