$sent_http_link

Описание

Переменная `$sent_http_link` используется в NGINX, когда в ответе задан заголовок Link. Эта переменная особенно полезна для API и веб‑сервисов, где предоставление информации о связанных ресурсах может улучшить обработку и навигацию на стороне клиента. Она заполняется на основе заголовка `Link`, определённого в контексте ответа, обычно сформированного с использованием нескольких URI, которые могут иметь отношение к текущему ресурсу. Когда формируется HTTP‑ответ, если заголовок `Link` был задан в конфигурации или динамически через Lua, `$sent_http_link` будет содержать это значение для последующей обработки. Его можно использовать при переписывании, логировании или дальнейших манипуляциях с ответом. Типичными значениями этой переменной будут строка, представляющая один или несколько URI, часто с указанием отношений (например, `rel=\"next\"` или `rel=\"prev\"`). Эта переменная особенно полезна при реализации пагинации в API, позволяя клиентам легко определить следующие или предыдущие страницы. Правильно устанавливая заголовок Link, NGINX может передавать релевантную информацию в ответе без необходимости существенной логики в приложении для обработки этих ссылок.

Пример конфига

http {
    server {
        location /api {
            add_header Link "; rel='next'";
        }
    }
}