HATEOAS concept overview in Express - Practice Problems & Coding Challenges

Challenge - 5 Problems

🧠 Conceptual

intermediate

What does HATEOAS stand for in REST APIs?

Choose the correct full form of HATEOAS.

A Hypermedia As The Engine Of Application State

B Hypertext Application Transfer Engine Of API Services

C Hypermedia Access To External Object Application Services

D Hypertext And Transfer Engine Of Application State

💡 Hint

It emphasizes using hypermedia links to guide client interactions.

HATEOAS means Hypermedia As The Engine Of Application State. It is a constraint of REST where clients interact with the application entirely through hypermedia provided dynamically by server responses.

❓ component_behavior

intermediate

What is the main benefit of HATEOAS in an Express REST API?

Select the best description of how HATEOAS benefits API clients.

A HATEOAS requires clients to send all data in query parameters.

B Clients discover available actions dynamically via links in responses, reducing hardcoded URLs.

C HATEOAS removes the need for HTTP methods like GET or POST.

D Clients must hardcode all endpoint URLs to interact with the API.

💡 Hint

Think about how clients learn what to do next without prior knowledge.

HATEOAS allows clients to navigate the API by following links provided in responses. This means clients do not need to hardcode URLs or know the API structure beforehand.

📝 Syntax

advanced

Which Express response correctly implements HATEOAS links for a user resource?

Given an Express route returning a user, select the correct JSON response including HATEOAS links.

Express

app.get('/users/:id', (req, res) => {
  const user = { id: req.params.id, name: 'Alice' };
  // Which response below correctly adds HATEOAS links?
});

A { "id": "1", "name": "Alice", "links": ["/users/1", "/users/1/friends"] }

B { "id": "1", "name": "Alice", "url": "/users/1", "friendsUrl": "/users/1/friends" }

C { "id": "1", "name": "Alice", "links": { "self": "/users/1", "friends": "/users/1/friends" } }

D { "id": "1", "name": "Alice", "links": [{ "rel": "self", "href": "/users/1" }, { "rel": "friends", "href": "/users/1/friends" }] }

💡 Hint

HATEOAS links are usually an array of objects with 'rel' and 'href' keys.

Option D correctly uses an array of link objects with 'rel' describing the relation and 'href' the URL. This is the standard HATEOAS pattern.

❓ state_output

advanced

What is the output of this Express route with HATEOAS links?

Consider this Express route code. What JSON does it send as response?

Express

app.get('/books/:id', (req, res) => {
  const bookId = req.params.id;
  res.json({
    id: bookId,
    title: 'Learn Express',
    links: [
      { rel: 'self', href: `/books/${bookId}` },
      { rel: 'author', href: `/authors/123` }
    ]
  });
});

// Request: GET /books/42

A { "id": "42", "title": "Learn Express", "links": [{ "rel": "self", "href": "/books/42" }, { "rel": "author", "href": "/authors/123" }] }

B { "id": 42, "title": "Learn Express", "links": [{ "rel": "self", "href": "/books/42" }, { "rel": "author", "href": "/authors/123" }] }

C { "id": "42", "title": "Learn Express", "links": [{ "rel": "self", "href": "/books/42" }] }

D { "id": "42", "title": "Learn Express" }

💡 Hint

Check the template literals and the links array carefully.

The route returns the book id as a string, the title, and two links with correct href values. Option A matches exactly.

🔧 Debug

expert

Why does this Express HATEOAS response cause client errors?

This Express route tries to send HATEOAS links but clients get errors. What is the problem?

Express

app.get('/items/:id', (req, res) => {
  const id = req.params.id;
  res.json({
    id,
    name: 'ItemName',
    links: {
      self: `/items/${id}`,
      related: `/items/${id}/related`
    }
  });
});

A The response is missing the HTTP status code 200.

B The template literals are incorrect and cause syntax errors.

C The 'links' property should be an array of objects with 'rel' and 'href', not an object.

D The 'id' variable is not defined before use.

💡 Hint

HATEOAS expects links in a specific format to be understood by clients.

Clients expect 'links' as an array of objects with 'rel' and 'href' keys. Using an object with keys 'self' and 'related' breaks this pattern and causes client errors.