> For the complete documentation index, see [llms.txt](https://www.happ.su/main/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.happ.su/main/ru/dev-docs/provider-id.md).

# Provider ID

Provider ID — уникальный идентификатор, связывающий вашу подписку с аккаунтом на сайте [happ-proxy.com](https://happ-proxy.com/). Он открывает доступ к расширенной статистике использования приложения и позволяет точно учитывать число активных устройств.

***

### Где взять Provider ID?

Для получения Provider ID необходимо зарегистрироваться на сайте [https://happ-proxy.com](https://happ-proxy.com/)\
После регистрации вы сможете его увидеть в верхней правой части экрана или в профиле пользователя.

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

Один раз в сутки приложение отправляет GET‑запрос на:

```
https://check.happ-proxy.com/provider?id={ProviderID}
```

В запрос включаются:

* **providerid** — ваш уникальный идентификатор;
* **хеш домена**, с которого загружена подписка;
* **HWID** устройства;
* **название и версия** операционной системы.

Хеш домена гарантирует привязку ProviderID к конкретному домену подписки и исключает его использование на других сайтах или в чужих подписках.

***

### **Способы передачи ProviderID**

Вы можете добавить ProviderID в подписку тремя способами:

1. **В URL** (query‑параметр)

   ```
   https://your-domain.com/sub/123#?providerid={ProviderID}
   ```
2. **В теле подписки** (комментарий)

   ```
   #providerid {ProviderID}
   vless://70cc48c5‑b2f4…
   vmess://zkIAU1JitkI…
   ```
3. **В HTTP‑заголовке** ответа

   ```
   HTTP/2 200 OK
   date: Wed, 14 Apr 2025 10:00:00 GMT
   content-type: application/json
   content-length: 3798
   content-disposition: attachment; filename="213"
   providerid: {ProviderID}
   ```

### Примеры добавления Provider ID

<details>

<summary>Remnawave</summary>

<figure><img src="/files/9ZW0VjwsykOlqXu8KCBj" alt="" width="375"><figcaption></figcaption></figure>

**Добавление ProviderID (на примере панели Remnawave)**

Скопируйте ваш ProviderID в панели управления happ-proxy.com.

1. В Remnawave в левом сайдбаре перейдите в раздел "Subscription" → "Settings"
2. Сверху выберите "Additional Response Headers"
3. Чтобы добавить хэдер нажмите на кнопку "Add header"
4. В поле "Key" пропишите название хедера: providerId
5. В поле "Value" пропишите скопированный раннее ваш ProviderID
6. Для применения изменений нажмите на кнопку "Save"

</details>