# Ограниченные и HWID-ссылки

> Ссылки на подписку с лимитом устройств или для одного устройства по HWID — адрес подписки пользователь не видит.

**Ограниченная ссылка** — подписку по ней можно добавить не больше чем на N устройств. **HWID-ссылка** — только на
одно устройство с заданным HWID.

## Создать ссылку

1. Кабинет → «Ссылки» → «Новая ссылка»: адрес подписки (на вашем [подтверждённом домене](https://flowlock.cc/docs/domains.md)), лимит
   устройств (1–1000), заметка для себя, срок действия. Для HWID-ссылки — ещё HWID устройства (лимит тогда 1).
2. Вы получите две ссылки на одно и то же:

```
flowlock://install/a7k2m9x4q8b3n6p5
https://flowlock.cc/i/a7k2m9x4q8b3n6p5
```

Вторую удобно отправлять в мессенджере: страница откроет FlowLock или предложит его скачать. Кабинет показывает и
QR-код этой ссылки.

## Как это работает

- Адрес подписки хранится на сервере FlowLock зашифрованным и выдаётся приложению, только пока у ссылки есть места.
  Устройство, которое уже получало ссылку, получит её снова без траты места (переустановка).
- Приложение спрашивает человека: «Добавить подписку провайдера «Мой VPN»?» — молча ничего не добавляется.
- Пользователь не видит адрес подписки: его нельзя скопировать, показать QR или поделиться им. На другие свои
  устройства пользователь переносит не адрес, а саму ссылку — и каждое занимает своё место.
- Мест нет — приложение пишет «Администратор подписки ограничил число устройств» и показывает ваши контакты.
- Для HWID-ссылки приложение спросит человека, можно ли отправить HWID, если «Отправлять HWID» у него выключено.
  Другой HWID — ссылка не сработает.

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

В списке ссылок видно, сколько мест занято. Для каждой ссылки можно:

- посмотреть устройства и **отвязать** любое — место освободится;
- изменить лимит (не меньше числа устройств на ссылке) и заметку;
- выключить и включить снова;
- удалить.

> **Отвязка не отзывает доступ.** Уже выданный адрес подписки продолжит работать. Чтобы закрыть доступ,
> смените токен подписки в своей панели.

Это защита от случайной раздачи, а не от решительного человека: на своём компьютере адрес можно перехватить.

## Через API

```sh
# ограниченная ссылка на 3 устройства
curl -s -X POST https://api.flowlock.cc/v1/provider/installs -H "Authorization: Bearer $FLOWLOCK_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://sub.example.com/abc123", "limit": 3, "note": "user 1042"}'

# HWID-ссылка
curl -s -X POST https://api.flowlock.cc/v1/provider/installs -H "Authorization: Bearer $FLOWLOCK_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://sub.example.com/abc123", "limit": 1, "hwid": "5f0c…"}'
```

Остальные вызовы — в [справочнике API](https://flowlock.cc/docs/api.md#ссылки). Ссылок в кабинете — до 5000.