La cabecera Link y los tipos de relación de enlace

Qué es

El RFC 8288 modela un enlace como un contexto, un tipo de relación, un destino y atributos de destino opcionales. En una cabecera se serializa así:

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

Reglas del RFC: varios enlaces se separan por comas; rel es obligatorio y solo cuenta su primera aparición, pero un único valor de rel puede enumerar varios tipos de relación separados por espacios; rev está obsoleto. Los nombres de relación registrados son tókenes en minúscula que se comparan sin distinguir mayúsculas de minúsculas; cualquier nombre no registrado debe ser una URI absoluta y debe ir entre comillas si contiene ; o ,. Los destinos relativos se resuelven contra el URI de la solicitud, nunca contra un <base> del cuerpo. El contexto es por defecto el recurso solicitado; anchor lo traslada a un fragmento o a otro URI. hreflang, media, title, title* y type son indicaciones sobre el destino. El registro de la IANA enumera los nombres registrados, entre ellos alternate, canonical, describedby, next, prev, first, last, self, license, service-desc, service-doc, deprecation, sunset, preload y preconnect. El RFC 8297 define la respuesta 103 Early Hints, cuyo propósito es enviar cabeceras Link antes de la respuesta final para que un cliente pueda empezar a obtener los recursos.

Por qué importa

JSON, los PDF, las imágenes y Markdown no tienen ningún elemento <link>. La cabecera les da enlaces canónicos, alternativos y de paginación que los agentes, los rastreadores y los clientes genéricos pueden leer sin analizar el cuerpo, y mantiene la lógica de paginación independiente del formato de la carga útil.

Cómo aplicarlo

• Paginar con rel="next" (y prev, first, last cuando resulte económico); omitir next en la última página para que un recorrido del cliente termine.
• Señalar las alternativas legibles por máquina con rel="alternate"; type="text/markdown", la descripción de la API con rel="service-desc", la documentación humana con rel="service-doc".
• Usar rel="canonical" en las representaciones no HTML, y rel="deprecation" y rel="sunset" junto a esas cabeceras.
• Enviar indicaciones de obtención anticipada como Link: </app.css>; rel="preload"; as="style"; as es un parámetro definido por HTML, transportado como extensión.
• Analizar con una biblioteca: los valores pueden repartirse entre varios campos Link, que equivalen a un solo campo unido por comas.

Trampas

Comillas: una URI de extensión con un punto y coma rompe los analizadores si no va entre comillas. Un enlace en una respuesta de error como un 404 tiene un contexto anónimo. Muchos enlaces inflan las cabeceras más allá de los límites del proxy; conviene reservar la cabecera para la navegación y poner los conjuntos grandes de enlaces en el cuerpo.