4.9.4. Varying Content Based Upon the Request (Contenu variant selon la requête)

4.9.4. Varying Content Based Upon the Request (Contenu variant selon la requête)

Lorsque la représentation d'une ressource peut varier en fonction d'aspects de la requête (tels que le champ d'en-tête Accept pour la négociation de contenu), le champ d'en-tête Vary DOIT (MUST) être utilisé pour indiquer quels champs d'en-tête de requête affectent la représentation sélectionnée.

Par exemple:

Vary: Accept, Accept-Language

indique que la représentation peut varier en fonction des champs d'en-tête Accept et Accept-Language.

Les applications qui utilisent la négociation de contenu ou d'autres variations basées sur les requêtes DOIVENT (MUST) utiliser le champ d'en-tête Vary de manière appropriée. Cela garantit que les caches peuvent correctement stocker et récupérer différentes représentations.

Cependant, les applications DEVRAIENT (SHOULD) être conscientes que l'utilisation de Vary peut réduire considérablement l'efficacité du cache, car les caches doivent stocker des copies séparées de la réponse pour chaque combinaison de valeurs de champs d'en-tête variables.