Aller au contenu principal

5. The Link Header Field (Le champ d'en-tête Link)

Le champ d'en-tête Link fournit un moyen de sérialiser les liens dans les en-têtes HTTP.

Aperçu

Équivalence sémantique :

  • Équivalent à l'élément HTML <LINK>
  • Équivalent à l'élément atom:link au niveau du flux Atom

Syntaxe ABNF

Link           = "Link" ":" #link-value
link-value = "<" URI-Reference ">" *( ";" link-param )
link-param = ( ( "rel" "=" relation-types )
| ( "anchor" "=" <"> URI-Reference <"> )
| ( "hreflang" "=" Language-Tag )
| ( "media" "=" ( MediaDesc | ( <"> MediaDesc <"> ) ) )
| ( "title" "=" quoted-string )
| ( "title*" "=" ext-value )
| ( "type" "=" ( media-type | quoted-mt ) ) )

Composants

5.1. IRI cible

  • Transmis comme URI-Reference entre crochets angulaires <>
  • Les URI relatifs sont résolus selon RFC 3986

5.2. IRI de contexte

  • Par défaut : IRI de la ressource demandée
  • Remplacement : Utiliser le paramètre anchor

5.3. Type de relation

  • Spécifié dans le paramètre rel
  • Ne doit pas (MUST NOT) apparaître plus d'une fois par link-value
  • Paramètre rev : OBSOLÈTE

5.4. Attributs de la cible

ParamètreDescription
hreflangIndication de langue pour la ressource cible
mediaMédia/medium prévu pour les informations de style
titleÉtiquette lisible par l'homme
title*Étiquette encodée (RFC 5987)
typeIndication de type de média

5.5. Exemples

Navigation simple :

Link: `http://example.com/TheBook/chapter2`; rel="previous";
title="chapitre précédent"

Plusieurs liens :

Link: </TheBook/chapter2>; rel="previous"; title*=UTF-8'fr'pr%C3%A9c%C3%A9dent,
</TheBook/chapter4>; rel="next"; title*=UTF-8'fr'suivant