Limited Links

Limited links are a feature that allows you to restrict the number of devices that can add a subscription (link) to the application.
In your account dashboard happ-proxy.com
, you specify the URL of your subscription, set the maximum number of allowed devices, and click "Generate Link."
You can then share the generated link with users, knowing that the subscription can only be installed on the specified number of devices — exceeding the limit is not possible.
Limited links can be created both through the web interface and via the API.
Creating via the Website
Provide the unencrypted URL of your subscription on the link‑creation page.
Specify the install limit (the maximum number of devices).
When you generate the link:
An InstallID parameter is automatically appended to the URL.
The link’s domain is stored in our database as a SHA‑256 hash (we never keep the raw domain for added security).
You’ll receive an encrypted link containing the InstallID.
Creating via the API
Send a GET request to:
https://api.happ-proxy.com/api/add-install?
provider_code={provider_code}&
auth_key={auth_key}&
install_limit={install_limit}
{provider_code} — your provider code (from your profile)
{auth_key} — your authorization key (from your profile)
{install_limit} — maximum number of devices allowed
API Response
Success
{ "rc": 1, "msg": "Ok", "install_code": "6P0hVao1fG5e" }
Error
{ "rc": 0, "msg": "Error description" }
Take the returned install_code and add it to your link as the InstallID parameter.
Example
Original URL:
https://url.com/sub
Final link:
https://url.com/sub#Your_TITLE?installid=Abcd1234
Tip: Encrypt the link so users cannot remove the InstallID parameter.
How It Works
When a link is added, the application calculates the SHA‑256 hash of the domain and sends a request to:
https://check.happ-proxy.com/install?id={domain_hash}&installid={InstallID}
In response, it receives the ProviderID
and the link status.
If the request cannot be transmitted (for example, if the site is blocked), the application will automatically retry after a VPN connection is established.
The happ-proxy.com
server receives the device's HWID
and responds positively if the installation limit for the link has not been exceeded.
If the limit is exceeded, the server returns a denial, and the application displays the following message:
"The subscription administrator has restricted access. Please contact technical support."
Last updated