L'en-tête Link et les types de relation de lien

Ce que c'est

La RFC 8288 modélise un lien comme un contexte, un type de relation, une cible et des attributs de cible facultatifs. Dans un en-tête, il se sérialise ainsi :

Link: </orders?cursor=abc>; rel="next",
      </openapi.json>; rel="service-desc"; type="application/json",
      </docs/orders>; rel="service-doc"

Règles issues de la RFC : plusieurs liens sont séparés par des virgules ; rel est obligatoire et seule sa première occurrence compte, mais une valeur rel peut lister plusieurs types de relation séparés par des espaces ; rev est déprécié. Les noms de relation enregistrés sont des jetons en minuscules comparés sans distinction de casse ; tout nom non enregistré doit être une URI absolue et entre guillemets s'il contient ; ou ,. Les cibles relatives se résolvent par rapport à l'URI de la requête, jamais par rapport à un <base> dans le corps. Le contexte prend par défaut la ressource demandée ; anchor le déplace vers un fragment ou une autre URI. hreflang, media, title, title* et type sont des indications sur la cible. Le registre IANA liste les noms enregistrés, parmi lesquels alternate, canonical, describedby, next, prev, first, last, self, license, service-desc, service-doc, deprecation, sunset, preload et preconnect. La RFC 8297 définit la réponse 103 Early Hints, dont le but est d'envoyer des en-têtes Link avant la réponse finale afin qu'un client puisse commencer à récupérer les ressources.

Pourquoi c'est important

JSON, les PDF, les images et Markdown n'ont pas d'élément <link>. L'en-tête leur donne des liens canoniques, alternatifs et de pagination que les agents, les robots d'indexation et les clients génériques peuvent lire sans analyser le corps, et il garde la logique de pagination indépendante du format de la charge utile.

Comment l'appliquer

• Paginer avec rel="next" (et prev, first, last lorsque c'est peu coûteux) ; omettre next sur la dernière page afin qu'un parcours côté client se termine.
• Faire pointer les alternatives lisibles par machine avec rel="alternate"; type="text/markdown", la description de l'API avec rel="service-desc", la documentation destinée aux humains avec rel="service-doc".
• Utiliser rel="canonical" sur les représentations non HTML, ainsi que rel="deprecation" et rel="sunset" aux côtés de ces en-têtes.
• Envoyer les indications de récupération anticipée sous la forme Link: </app.css>; rel="preload"; as="style" ; as est un paramètre défini par HTML, porté ici comme une extension.
• Analyser avec une bibliothèque : les valeurs peuvent être réparties sur plusieurs champs Link, équivalents à un seul champ joint par des virgules.

Pièges

Guillemets : une URI d'extension contenant un point-virgule casse les analyseurs si elle n'est pas mise entre guillemets. Un lien sur une réponse d'erreur telle qu'un 404 a un contexte anonyme. Un grand nombre de liens fait gonfler les en-têtes au-delà des limites des proxys ; réserver l'en-tête à la navigation et placer les grands ensembles de liens dans le corps.