state transition

A change of a resource from one state to another, such as a task moving from open to done, modelled as its own resource.

In more detail

Hypermedia can offer a transition only when the current state allows it. Modelling the transition as a resource makes its rules, status codes and retries explicit.

Example

In the APIs course: Instead of hiding a verb in a path, the course models completion as /tasks/3/completion and uses PUT, which is idempotent, so repeating it is harmless.

Related terms

Taught in

References