The following section discusses in detail what are safe and idempotent methods.
Safe methods are methods that do not change the state on the server. For example,
GET /v1/coffees/orders/1234 is a safe method.
Safe methods can be cached.
HEAD are safe methods.
PUT method is not safe as it will create or modify a resource on the server. The
POST method is not safe for the same reasons. The
DELETE method is not safe as it deletes a resource on the server.
An idempotent method is a method that will produce the same results irrespective of how many times it is called.
GET method is idempotent, as multiple calls to the
GET resource will always return the same response.
PUT method ...