Request methods
| Method | Safe | Idempotent | Body | Notes |
|---|---|---|---|---|
GET | yes | yes | no | Transfer a current representation of the target resource. |
HEAD | yes | yes | no | Same as GET but without a response body. |
POST | no | no | yes | Perform resource specific processing on the payload. |
PUT | no | yes | yes | Replace the target resource with the payload. |
PATCH | no | no | yes | Apply a partial modification to the resource. |
DELETE | no | yes | optional | Remove the association between target and function. |
OPTIONS | yes | yes | optional | Describe the communication options for the target. |
TRACE | yes | yes | no | Perform a loop back test along the path to the target. |
Conditional requests
A conditional request carries a precondition header such as If-Match or If-None-Match. When the precondition fails the server answers 412 Precondition Failed, or 304 Not Modified for a successful cache validation.