> For the complete documentation index, see [llms.txt](https://incy.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://incy.gitbook.io/docs/dokumentaciya-dlya-razrabotchikov/deep-links.md).

# Deep-Links

### Поддерживаемые схемы

Приложение обрабатывает ссылки с любой зарегистрированной схемой (`incy://`, и др.). Также поддерживаются прямые протокольные ссылки.

### Управление VPN

| Ссылка                         | Описание                             |
| ------------------------------ | ------------------------------------ |
| `://connect` или `://open`     | Подключить VPN                       |
| `://disconnect` или `://close` | Отключить VPN                        |
| `://toggle`                    | Переключить состояние VPN            |
| `://status`                    | Открыть приложение (показать статус) |

### Импорт конфигураций

| Ссылка             | Описание                                                                        |
| ------------------ | ------------------------------------------------------------------------------- |
| `://import/{data}` | Автоопределение типа данных (URL подписки, конфигурация сервера, несколько URL) |
| `://add/{url}`     | Добавить подписку или конфигурацию напрямую                                     |

#### Протокольные ссылки

Прямое добавление серверов через протокольные ссылки:

```
vless://uuid@server:443?security=tls&type=ws&sni=example.com#Server Name
vmess://eyJhZGQiOiJzZXJ2ZXIiLCJwb3J0Ijo0NDN9
trojan://password@server:443?security=tls&sni=example.com#Server Name
ss://method:password@server:8388#Server Name
hysteria2://password@server:443?sni=example.com#Server Name
socks://user:pass@server:1080#Server Name
wireguard://secretKey@server:51820?publickey=KEY&address=10.0.0.2#Server Name
```

### Маршрутизация

| Ссылка                       | Описание                                                        |
| ---------------------------- | --------------------------------------------------------------- |
| `://routing/add/{base64}`    | Добавить профиль маршрутизации                                  |
| `://routing/onadd/{base64}`  | Добавить и сразу активировать профиль                           |
| `://routing/onadd/{url}`     | Скачать профиль по URL (одноразовый импорт, без автообновления) |
| `://autorouting/onadd/{url}` | Скачать профиль по URL и установить автообновление              |
| `://autorouting/add/{url}`   | Скачать профиль по URL и установить автообновление              |
| `://onadd/{url}`             | Сокращённая форма (одноразовый импорт, без автообновления)      |

Подробнее: routing.md, autorouting.md.

#### Query-параметр

Для совместимости поддерживается передача данных через query-параметр `data` (Android, iOS):

```
://routing/add?data={base64}
://routing/onadd?data={base64}
```

#### Определение типа данных

Тип определяется **по схеме ссылки**:

* `://autorouting/` — автообновление (`sourceURL` устанавливается)
* `://routing/` — одноразовый импорт (без `sourceURL`, без автообновления)

Если данные после `onadd/` — URL (`http://`/`https://`), профиль скачивается по этому URL. Если base64 — декодируется напрямую.

### Примеры

#### Подключение VPN

```
incy://connect
```

#### Импорт подписки

```
incy://import/https://example.com/api/subscription/abc123
```

#### Добавление сервера

```
incy://add/vless://uuid@server:443?security=tls#MyServer
```

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

```
incy://autorouting/onadd/https://github.com/user/repo/blob/main/profile.json
```