The HyperText Transfer Protocol (HTTP) If-Unmodified-Since
request header makes the request for the resource conditional: the server will send the requested resource or accept it in the case of a POST
or another non-safe method only if the resource has not been modified after the date specified by this HTTP header. If the resource has been modified after the specified date, the response will be a 412 Precondition Failed
error.
The If-Unmodified-Since
HTTP header is commonly used in the following situations:
- In conjunction with non-safe methods, like
POST
, this header can be used to implement an optimistic concurrency control, as is done by some wikis: editions are rejected if the stored document has been modified since the original was retrieved. - In conjunction with a range request using the
Range
header, this header can be used to ensure that the new fragment requested comes from an unmodified document.
Header type | Request header |
---|---|
Forbidden header name | no |