If-None-Match

E204878

If-None-Match is an HTTP request header used for conditional requests, typically with ETags, to perform cache validation or conditional updates without unnecessarily transferring data.

All labels observed (1)

Label Occurrences
If-None-Match canonical 1

How this entity was disambiguated

Statements (46)

Predicate Object
instanceOf HTTP request header field
conditional request header
applicableTo selected representation of the target resource
avoids unnecessary data transfer
cacheBenefit reduces bandwidth usage
reduces server load
canUseWeakETags yes
clientRequirement client must store ETag from previous response
comparisonRule condition is true if none of the listed ETags match the current ETag
comparisonType strong comparison by default
conditionBasis entity tag comparison
definedIn RFC 7232
effectOnGET enables conditional retrieval based on ETag
effectOnPUT prevents overwriting when resource state already matches given ETag
headerType request header
operatesOn current ETag of the resource
primaryPurpose cache validation
conditional updates
relatedHeader ETag
If-Match
If-Modified-Since
replacesSpecification RFC 2616 section on conditional requests
responseStatusOnMatchGET 304 Not Modified
responseStatusOnMatchUnsafe 412 Precondition Failed
securityConsideration can help avoid lost updates when used with ETags
serverBehaviorOnMatch may reject state-changing requests with 412 Precondition Failed
may return 304 Not Modified for GET or HEAD
serverBehaviorOnNoMatch processes request normally
supportsValue multiple ETags
single ETag
wildcard *
syntaxExample If-None-Match: "etag1", "etag2"
If-None-Match: "etagvalue"
If-None-Match: *
typicalUseCase RESTful APIs for conditional updates
web browsers validating cached resources
usedFor client cache revalidation
optimistic concurrency control
usedInMethod DELETE
GET
HEAD
PUT
other safe and unsafe HTTP methods
usedInProtocol HTTP
usedWith ETag header
wildcardSemantics * matches any current representation

How these facts were elicited

Referenced by (1)

Full triples — surface form annotated when it differs from this entity's canonical label.

RFC 7232 definesHeaderField If-None-Match