In a REST-style API, a URI such as /orders/42 identifies an order resource. GET reads its representation, POST creates within a collection, and PATCH applies a specified change. Clients need not learn a new verb in every URI.
The demo applies methods to one resource and changes its visible state. Document method semantics and response codes in the contract, and avoid exposing internal implementation structure directly in the URI.
When to use
Use it when designing consistent paths and methods for an HTTP resource API.