> For the complete documentation index, see [llms.txt](https://kuik.gitbook.io/kuik-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kuik.gitbook.io/kuik-docs/razrabotchikam/http-zagolovki.md).

# HTTP-заголовки

Заголовки применяются к подписке после успешного импорта или обновления. Для новых параметров оформления и автоматизации используйте версии с поддержкой User-Agent формата `KUIK/<версия>/<платформа>`.

## Метаданные подписки

| Заголовок ответа                             | Значение                                                                                                                                                                                             |
| -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `profile-title`                              | Название подписки. После декодирования вторая строка может содержать описание.                                                                                                                       |
| `subscription-name`                          | Запасное название. iOS также может использовать имя файла из `Content-Disposition`.                                                                                                                  |
| `profile-description`                        | Описание карточки подписки. Имеет приоритет над второй строкой заголовка с названием.                                                                                                                |
| `subscription-userinfo`                      | Значения `upload`, `download`, `total` в байтах и `expire` в Unix-секундах. Поля разделяются точкой с запятой.                                                                                       |
| `subscription-refill-date`                   | Дата сброса лимита в Unix-секундах.                                                                                                                                                                  |
| `support-url`                                | HTTPS-ссылка кнопки «Поддержка».                                                                                                                                                                     |
| `support-email`                              | Адрес электронной почты провайдера, например `help@example.com`. Добавляет кнопку для письма.                                                                                                        |
| `hide-url`                                   | `1` скрывает действия с URL подписки, включая копирование, отправку и QR-код. На iOS подписка и её серверы также исключаются из новых резервных копий и синхронизации. `0` возвращает обычный режим. |
| `profile-web-page-url`                       | HTTPS-ссылка кнопки «Сайт». Запасной вариант — `homepage`.                                                                                                                                           |
| `announce`, `announce-url`                   | Текст объявления и HTTPS-ссылка для перехода.                                                                                                                                                        |
| `sort-order`                                 | Сортировка серверов. Значения `none`, `name`, `ping`.                                                                                                                                                |
| `auto-select-sticky`                         | `true` включает закрепление выбранного сервера для совместимых пулов автовыбора. `false` отключает закрепление, в том числе если в JSON оно включено. Действует для этой подписки.                   |
| `routing`                                    | [Профиль маршрутизации для подписки](https://kuik.gitbook.io/kuik-docs/razrabotchikam/marshrutizaciya.md).                                                                                           |
| `x-hwid-max-devices-reached`, `x-hwid-limit` | При значении `true` приложение сообщает о [лимите устройств](https://kuik.gitbook.io/kuik-docs/razrabotchikam/hwid-i-limity-ustroistv.md).                                                           |

Для кириллицы в текстовых полях кодируйте UTF-8 в Base64 и добавляйте префикс `base64:` или `rwEncodeBase64:`. Например, название «КУИК» можно отправить как `profile-title: base64:0JrQo9CY0Jo=`.

Корректный `auto-select-sticky: true` или `auto-select-sticky: false` имеет приоритет над JSON профиля и задаёт режим для подписки. При этом пользовательский переключатель закрепления сервера скрыт. Если заголовок отсутствует или некорректен, сохраняется прежнее поведение. Для прежних подписок без отдельной настройки закрепление включено по умолчанию.

## Автообновление и пинг

| Заголовок ответа                       | Что включает                                                                                                                                        |
| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| `subscription-auto-update-enable`      | Обновление подписки по расписанию, пока KUIK открыт.                                                                                                |
| `profile-update-interval`              | Интервал в часах, целое число от `1` до `8760`.                                                                                                     |
| `subscription-auto-update-open-enable` | Обновление этой подписки при очередном запуске приложения.                                                                                          |
| `subscription-ping-onopen-enabled`     | Пинг при запуске. iOS проверяет список серверов подписки, Android проверяет выбранный сервер.                                                       |
| `subscription-ping-onupdate-enabled`   | Проверку серверов после обновления. Также принимается `ping-on-update`.                                                                             |
| `ping-display-mode`                    | Вид результата. `number` показывает число в миллисекундах, `bars` — цветной индикатор, `both` — оба. `graph` равнозначно `bars`.                    |
| `ping-method`                          | Метод проверки. `tcp` проверяет соединение с сервером, `kuik` отправляет запрос через профиль, `http-get` и `http-head` обращаются к тестовому URL. |

Для переключателей используйте `1` или `true` для включения и `0` или `false` для выключения. При отсутствии значения приложение использует пользовательские настройки. Явно заданный пользователем интервал подписки имеет приоритет.

Явно выбранные пользователем метод и отображение имеют приоритет над заголовками. Чтобы использовать предложение провайдера, выберите «По умолчанию» в настройках пинга.

## Цвета подписки

`color-profile` принимает компактный JSON или этот же JSON с префиксом Base64. Цвета задаются в формате `#RRGGBB` или `#RRGGBBAA`, где последние две цифры задают прозрачность.

| Ключ JSON                          | Где применяется                                 |
| ---------------------------------- | ----------------------------------------------- |
| `elipseColors` или `ellipseColors` | Палитра сферы в виде массива цветов.            |
| `buttonColor`                      | Цвет сферы, если палитра пустая.                |
| `topBarButtonsColor`               | Иконки настроек и добавления на главном экране. |
| `settingsControlsTintColor`        | Акцентный цвет элементов интерфейса.            |
| `supportIconColor`                 | Иконка «Поддержка».                             |
| `profileWebPageIconColor`          | Иконка «Сайт».                                  |
| `additionalOptionsButtonColor`     | Иконка меню действий подписки на iOS.           |

Цвета относятся к выбранной подписке. Для сброса используйте `color-profile: resetcolors`.

## Автообновляемая маршрутизация

| Заголовок ответа              | Значение                                                                                                                                                                    |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `autorouting`                 | Ссылка вида `incy://autorouting/onadd/https://example.com/routing.json`. Действие `onadd` выбирает профиль для подписки, а `add` добавляет его в список для ручного выбора. |
| `routing-geo-update-interval` | Интервал обновления GeoIP и GeoSite в часах, от `1` до `8760`. Значение `0` отключает автоматическую проверку геофайлов по расписанию.                                      |

Autorouting загружает профиль при импорте и обновлении подписки. KUIK также проверяет срок отдельного обновления профиля раз в сутки, пока приложение открыто. Проверка геофайлов идёт по собственному интервалу. Обновлённые правила вступают в силу при следующем подключении.

## VPN по приложениям на Android

| Заголовок ответа       | Значение                                                                                                                                 |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `per-app-proxy-enable` | `1` включает настройки VPN по приложениям для подписки. `0` их отключает.                                                                |
| `per-app-proxy-mode`   | `bypass` выводит выбранные приложения из туннеля. `proxy` направляет в туннель только выбранные приложения.                              |
| `per-app-proxy-list`   | Имена пакетов через запятую, с новой строки, в `base64:` или по HTTPS-ссылке на список. Пример `com.android.chrome,org.mozilla.firefox`. |

Параметры применяются при следующем подключении этой подписки.

## Транспорт и DNS

| Заголовок ответа                    | Значение                                                                                                                     |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `fragmentation-enable`              | `1` включает TCP-фрагментацию, `0` выключает.                                                                                |
| `fragmentation-packets`             | `tlshello`, номер или диапазон пакетов, например `1-3`, либо `all`.                                                          |
| `fragmentation-length`              | Длина фрагментов в байтах, например `10-20`.                                                                                 |
| `fragmentation-interval`            | Задержка между фрагментами в миллисекундах, например `0-10`.                                                                 |
| `noises-enable`                     | `1` включает UDP-шум для совместимых транспортов, например Hysteria2 и WireGuard.                                            |
| `noises-type`                       | `rand` для случайных байтов, `str` для текста, `hex` для байтов в шестнадцатеричном виде.                                    |
| `noises-packet`                     | Для `rand` задаёт размер или диапазон в байтах, например `10-20`. Форматы `str` и `hex` принимают содержимое пакета.         |
| `noises-delay`                      | Задержка в миллисекундах, например `10-50`.                                                                                  |
| `server-address-resolve-enable`     | `1` включает предварительный резолв домена VPN-сервера через DoH.                                                            |
| `server-address-resolve-dns-domain` | HTTPS-адрес DoH-сервера, например `https://cloudflare-dns.com/dns-query`.                                                    |
| `server-address-resolve-dns-ip`     | IP-адрес DoH-сервера для первого соединения, например `1.1.1.1`.                                                             |
| `no-limit-enabled`                  | iOS. `1` включает экономию памяти для туннеля подписки. Выбранный вручную режим экономии памяти сохраняет приоритет над `0`. |

## Заголовки запроса

KUIK отправляет `User-Agent: KUIK/<версия>/ios` или `KUIK/<версия>/android`, а также `x-client: KUIK`, `x-app-version`, `Accept`, `Accept-Language` и `x-device-locale`. Набор полей при включённом HWID описан на странице [HWID и лимиты устройств](https://kuik.gitbook.io/kuik-docs/razrabotchikam/hwid-i-limity-ustroistv.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://kuik.gitbook.io/kuik-docs/razrabotchikam/http-zagolovki.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
