Vote API options

You can use this API flow to reward your players for voting. Take note that this does not work when you have Votifier in use / enabled.
All endpoints are only valid for the current running day in UTC ( GMT +0 ).

To make use of this API, enable and grab your API key inside your Edit Server area.

After your player clicks on the voting link, wait a bit and make a POST request to the following endpoint with the required parameters.

POST https://minecraft-server.net/api/
Parameter Value Data Type Required
action checkVote String Yes
key Your Server API Key String Yes
player Player from your server doing the vote String Yes
Response Description
0 Player not yet voted. Repeat this step in a few seconds.
1 Player has voted and not marked as claimed. Reward the player and continue on step 2.
2 Player has voted and was already marked as claimed. Stop here and do not process further.

Once you got the proper response from step 1, make a POST request to the following endpoint with the required parameters.

POST https://minecraft-server.net/api/
Parameter Value Data Type Required
action setClaimed String Yes
key Your Server API Key String Yes
player Player from your server doing the vote String Yes
Response Description
0 Player has not yet voted today. Did you handled step 1 properly?.
1 Players vote has been marked as claimed previously. This is a repeated call and aborted.
2 Players vote has been marked as claimed.

Global Error Response

Each endpoint may also present the following responses in case something was not setup correctly

  • Access denied.
  • Access denied. Please enable the api inside your user control panel.
  • Access denied. Please check the api documentation for parameter "action".
  • Access denied. Please check the api documentation for parameter "player".