# 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>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://www.happ.su/main/ru/dev-docs/provider-id.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.