Заголовок Link и типы отношений ссылок

Что это такое

RFC 8288 представляет ссылку как контекст, тип отношения, цель и необязательные атрибуты цели. В заголовке она записывается так:

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

Правила RFC: несколько ссылок разделяются запятыми; rel обязателен, и учитывается только его первое вхождение, но одно значение rel может перечислять несколько типов отношений через пробел; rev устарел. Зарегистрированные имена отношений — это токены в нижнем регистре, сравниваемые без учёта регистра; незарегистрированное отношение должно быть абсолютным URI, заключённым в кавычки, если оно содержит ; или ,. Относительные адреса целей разрешаются относительно URI запроса, а не относительно <base> в теле ответа. По умолчанию контекстом является запрошенный ресурс; anchor переносит его на фрагмент или другой URI. hreflang, media, title, title* и type служат подсказками о цели. Реестр IANA содержит зарегистрированные имена, в том числе alternate, canonical, describedby, next, prev, first, last, self, license, service-desc, service-doc, deprecation, sunset, preload и preconnect. RFC 8297 определяет ответ 103 Early Hints: он передаёт заголовки Link до окончательного ответа, чтобы клиент мог начать загрузку.

Почему это важно

У JSON, PDF, изображений и Markdown нет элемента <link>. Заголовок предоставляет им канонические, альтернативные и постраничные ссылки, которые агенты, поисковые роботы и универсальные клиенты могут читать без разбора тела, а логика постраничного обхода остаётся независимой от формата данных.

Как применять

• Для постраничного обхода используйте rel="next", а также prev, first, last, когда их легко вычислить; на последней странице не передавайте next, чтобы клиент завершил обход.
• Для машиночитаемых альтернатив используйте rel="alternate"; type="text/markdown", для описания API — rel="service-desc", для документации для людей — rel="service-doc".
• Используйте rel="canonical" для представлений не в HTML, а rel="deprecation" и rel="sunset" — вместе с соответствующими заголовками.
• Передавайте подсказки ранней загрузки как Link: </app.css>; rel="preload"; as="style"; as — параметр, определённый HTML и передаваемый как расширение.
• Используйте библиотеку для разбора: значения могут быть распределены между несколькими полями Link, эквивалентными одному полю с объединением через запятую.

Подводные камни

Кавычки: URI расширения с точкой с запятой нарушает работу парсеров, если не заключён в кавычки. Ссылка в ответе об ошибке, например 404, имеет анонимный контекст. Большое число ссылок раздувает заголовки сверх ограничений прокси; оставляйте в заголовке навигацию, а большие наборы ссылок помещайте в тело.