# INCY Developer Documentation

> Technical documentation for integrating with the INCY app: subscription format, share-link parameters, full Xray configs, routing, deep links, HWID, Premium API, provider settings, and examples. Bilingual (RU default, EN copies live at /en/).

## Overview
- [Главная](https://docs.incy.cc/): Техническая документация по интеграции с приложением INCY.
- [Примеры](https://docs.incy.cc/examples/): Готовые примеры для интеграции маршрутизации и автообновляемой маршрутизации в подписки INCY.

## Подписки и серверы
- [Формат подписки](https://docs.incy.cc/subscription-format/): Описание форматов подписок, поддерживаемых протоколов и HTTP-заголовков.
- [Параметры share-ссылок](https://docs.incy.cc/share-links/): Описание параметров для протокольных ссылок серверов (VLESS, VMess, Trojan, Shadowsocks, Hysteria2, SOCKS5, WireGuard).
- [Полные Xray-конфигурации](https://docs.incy.cc/full-xray-config/): Подписка может возвращать полные конфигурационные файлы xray-core с балансировщиками, обсерваториями и кастомной маршрутизацией. Такие конфигурации передаются в xray-core практически без изменений.
- [Управление приложением](https://docs.incy.cc/app-management/): Параметры для управления поведением приложения через HTTP-заголовки подписки и строки в теле ответа.

## Маршрутизация
- [Routing](https://docs.incy.cc/routing/): Приложение поддерживает настройку маршрутизации трафика через профили маршрутизации. В приложении предустановлены геофайлы для работы сразу после установки. Обновление происходит при обновлении профил
- [Autorouting](https://docs.incy.cc/autorouting/): Расширение функционала маршрутизации, позволяющее привязать профиль к удалённому URL-источнику. Профиль периодически скачивается и обновляется автоматически.

## Интеграция
- [Deep Links](https://docs.incy.cc/deep-links/): Приложение поддерживает deep link ссылки для управления VPN, импорта конфигураций и настройки маршрутизации.
- [Передача подписки на ТВ](https://docs.incy.cc/tv-relay/): Перенос подписки на Apple TV / Android TV с телефона — из любой сети, даже
- [HWID](https://docs.incy.cc/hwid/): Аппаратный идентификатор устройства, используемый для привязки подписок к конкретным устройствам и отслеживания активных подключений.
- [Premium API](https://docs.incy.cc/premium-api/): Система управления подписками с шифрованием на основе доменных хешей. Позволяет провайдерам настраивать внешний вид приложения, параметры серверов и уведомления для своих пользователей.
- [Документация для ИИ (MCP)](https://docs.incy.cc/ai-mcp/): Документацию INCY можно подключить к ИИ-ассистентам (Claude Code, Codex, Cursor и др.), чтобы они автоматически подтягивали актуальные форматы подписок, заголовки, deep-links и Premium API — и писали 

## Настройки провайдера
- [Пресет-иконки](https://docs.incy.cc/icon-presets/): Иконки, которые отображаются рядом с ссылками Бот / Канал / Поддержка в карточке подписки (режим liteMode). Провайдер выбирает иконку по ключу из пресет-набора — каждая платформа (Android, iOS, Deskto
- [Админ-доступ по HWID](https://docs.incy.cc/admin-hwids/): adminHwids — список HWID устройств, которым провайдер выдал админ-привилегии в рамках конкретного домена подписки. Привилегий две: просмотр/правка конфигов серверов прямо в приложении и отправка push-
- [Push-уведомления провайдера](https://docs.incy.cc/provider-notifications/): Провайдеры с активным Premium могут рассылать push-уведомления своим подписчикам. Все сообщения проходят модерацию в INCY, кроме случая отправки на собственное устройство через admin HWID.

## Premium и биллинг
- [Premium биллинг](https://docs.incy.cc/premium-billing/): Система оплаты и управления подписками INCY Premium для провайдеров.
- [VPN Аукцион](https://docs.incy.cc/auction/): Еженедельный аукцион за размещение рекламы VPN-сервисов в канале «Рекомендованные VPN».