If-None-Match

L'en-tête de requête HTTP If-None-Match permet de conditionner la requête. Pour les méthodes GET et HEAD, le serveur renvoie la ressource demandée, avec un statut 200, seulement si elle n'a pas un ETag correspondant à ceux fournis. Pour les autres méthodes, la requête ne sera traitée que si l'ETag de l'éventuelle ressource existante ne correspond à aucune des valeurs listées.

Quand la condition échoue pour les méthodes GET et HEAD, le serveur doit retourner un code statut HTTP 304 (Not Modified). Pour les méthodes appliquant des changements côté serveur, le code statut 412 (Precondition Failed) est utilisé. Notez que le serveur générant une réponse 304 DOIT générer toutes les en-têtes qui auraient été envoyées avec une réponse 200 (OK) à la même requête : Cache-Control, Content-Location, Date, ETag, Expires, and Vary.

La comparaison avec l'ETag stocké utilise l'algorithme de comparaison faible, c'est-à-dire que 2 fichiers sont considérés identiques pas seulement s'ils sont identiques octet à octet mais si leurs contenus sont équivalents. Par exemple, 2 pages dont seule la date de génération dans le pied de page diffère seraient considérées identiques.

Quand utilisé avec If-Modified-Since, il a la priorité (si le serveur le supporte).

Il y a 2 cas d'utilisation communs:

• Pour les méthodes GET and HEAD, pour mettre à jour une entité en cache qui a un ETag associé.
• Pour les autres méthodes, et en particulier pour PUT, If-None-Match avec pour valeur * peut être utilisé pour sauver un fichier dont on ne sait pas s'il existe, garantissant qu'un autre téléversement n'a pas été fait avant, perdant les données du précédent chargement ; ce problème est une variation du problème de la mise à jour perdue.

Type d'en-tête	En-tête de requête
Nom d'en-tête interdit	non

If-None-Match: "<valeur_etag>"
If-None-Match: "<valeur_etag>", "<valeur_etag>", …
If-None-Match: *

If-None-Match: "bfc13a64729c4290ef5b2c2730249c88ca92d82d"

If-None-Match: W/"67ab43", "54ed21", "7892dd"

If-None-Match: *