API vote


Published on 2018-04-18




With our API you have the possibility to check if a player has voted for your server and reward him in game.

For this, you must use a plugin compatible with Trackyserver.

You will find the KEY and the ID of your server in the edit page.

 

Step by step explanations


1) The player types the command /vote on the server to display the voting link to Trackyserver.com.

2) The player goes to the voting page and clicks on "API vote" where he will have to identify himself via Steam or Discord.

Once the vote is done, the player's steamid / discordid is saved in our database.

3) The player types the command /claim or /checkvote on the server, the plugin sends a request to the Trackyserver API to check if he has voted during the last 24 hours and if he has not already received his reward.

4) The player is rewarded.


Claim vote request for developers


To claim the vote and reward player, you can query our API with a GET http web request:

For Steam:

https://api.trackyserver.com/vote/?action=claim&key={ServerKey}&steamid={UserSteamID}

For Discord:

https://api.trackyserver.com/vote/?action=claim&key={ServerKey}&discordid={UserDiscordID}
API response Definition
0 API key is incorrect or steamid / discordid was not found in our database.
Player has not voted in the past 24 hours.
1 Player’s steamid / discordid was found in our database. Player has voted in the last 24 hours !
You can reward the player in the game (the vote is now CLAIM)
2 The player has voted in the last 24 hours but has already claimed his reward.
Do not reward him anymore !

Check vote request for developers


This query URL does not CLAIM, it is useful only to check if a player has voted for your server during the last 24 hours.

For Steam:

https://api.trackyserver.com/vote/?action=status&key={ServerKey}&steamid={UserSteamID}

For Discord:

https://api.trackyserver.com/vote/?action=status&key={ServerKey}&discordid={UserDiscordID}
API response Definition
0 API key is incorrect or steamid / discordid was not found in our database.
Player has not voted in the past 24 hours.
1 Player has voted but has not yet claimed his reward
2 Player voted and claimed his reward

 

EasyVote plugin for Rust


Download EasyVote

 

Example with the Votifier plugin for Unturned


Download Votifier

 

Add your server to our Unturned servers and install the plugin.

Add the following line in the Votifier.configuration.xml file by adding the api KEY.

service name="trackyserver.com" apikey=""

Add the following lines in ServiceDefinitions

https://api.trackyserver.com/vote/?action=claim&key={0}&steamid={1}
https://api.trackyserver.com/vote/?action=status&key={0}&steamid={1}
    

Type /reward in game to receive your reward, the player must first have the reward permission.

 

Example with the FiveM script


Download FiveM vote script

 

/vote (To display the server's voting link)

/checkvote (Type this command after voting for the server to receive your reward)