1. Get the API key for your server
1.1 First, register on hotservers.org, add your server details, and complete the visibility requirements. To appear on the server listings, your server must display a HotServers voting banner on its website and receive at least 3 votes after each monthly voting reset.
1.2 Click the profile icon → My Servers, or go to Edit Profile → My Servers.
1.3 On the server page, in the right sidebar under the Owner Actions section, you will find two options: API Integration (your server token and API links) and Integration Docs (the API Integration Guide). Note: each of your servers will have its own unique API keys.
1.4 API Integration
1.4.1. API TOKEN - a unique API key generated for each server.
1.4.2. TOTAL VOTES API link - a pre-generated URL containing your server ID and API key, used to retrieve the total number of votes for your server.
1.4.3. IP VOTED CHECK API link - a pre-generated URL containing your server ID and API key, except the IP address of your visitors/players. You must replace the “IP_ADDRESS” text in the link.
2. Total Votes API
When checking the total votes for your server, use the TOTAL VOTES API link (1.4.2). The URL should look like this:
(image to be uploaded)
Returns a JSON response with “server_votes” containing the number (integer) of votes and “response_code” with the HTTP response status code (example: 200)
Example response:
(image to be uploaded)
3. Check if IP address voted
In some cases, you may need to verify whether a player or site visitor has already voted for your server. This functionality is supported by the system.
To check if an IP address has voted, use the IP VOTED CHECK API link (1.4.3). This link is automatically generated for your server, but requires a small modification before use.
If you follow the instructions in 1. Get the API key for your server, your generated URL will look like this:
(example URL, image to be uploaded)
Note that the placeholder IP_ADDRESS must be replaced dynamically with the actual player or visitor IP address before making the URL request.
After replacement, the final URL should be the same, except for the inserted real IP address.
Example after modification:
(example URL, image to be uploaded)
This endpoint returns a JSON response with vote information for the specified IP address (when the IP has voted).
Example JSON response:
(image to be uploaded)
"has_voted" - boolean (true/false) value. Will return “true” if the IP address has voted, otherwise “false”.
“server_time” / “hotserversServerTime” - datetime string showing the current date and time on the server, used if you need to calculate time differences.
“vote_time” - unix timestamp integer showing the exact time when the IP address has voted. If the IP address hasn't voted, it will return 0.
“response_code” - returns standard HTTP response code for success - 200 if you called the correct URL. Otherwise, it will return the appropriate HTTP response code for the error.
“response_error” - returns a string showing the error if there is one. Otherwise, it will return “false”, indicating that there is no error.
Example success JSON response:
(image to be uploaded)
4. Download FREE integration code
We have made it very easy for you. If you need a plug-and-play solution, you can download a script that already includes the required API calls, and you only need to replace your Server ID and API TOKEN (see point 1).
4.1 New voting reward system source files (version 2). You can clone this repository, or better yet, star it, fork it, modify it, and improve it:
Link to GitHub Repository: https://github.com/nightw0lv/VDSystem
Big thanks to @nightw0lv for maintaining the voting system and working with us to create a seamless plug-and-play integration for you, our valued players and server owners.
4.2. OLD voting reward system source files (version 1): DOWNLOAD THE ZIP.
Important notes:*
1. Your API token is the same for all servers in your account.
2. If you regenerate your API token from your profile, you will need to update the API links for your server in your integration code. The old links will become invalid, so be careful when regenerating your API token.
3. API URL address is case-sensitive and must be copied exactly as shown, otherwise it will not work.
If you need additional L2 development services, you can use the discount code HOTSERVERS on our partner developer’s website: https://shop.denart-designs.com/
In case you need L2 web development functionalities for your website, we also offer our own services, which can be found under the "Advertise" menu → Website Development section.
For more information, feel free to contact us. You can also follow us on social media and Discord to stay updated on our latest developments.