Vote API
Two GET endpoints that return a plain integer. The same shape reward plugins already speak, so an existing configuration needs only a URL change.
The two endpoints
Replace KEY with the vote key from your dashboard, and NAME with the player’s in-game name. steamid= works in place of username= if that is what your plugin sends.
GET https://www.dinodestination.com/api/vote/status?key=KEY&username=NAME
GET https://www.dinodestination.com/api/vote/claim?key=KEY&username=NAMEWhat comes back
The body is a single character and nothing else — no JSON, no newline. The status code is always 200, including when something is wrong, because a plugin parsing an integer does not read status codes and an HTML error page reads to a server owner like a broken config.
- 0 — they have not voted, or the key is wrong, or no player was named. All three are the same answer on purpose.
- 1 — they have voted and the reward has not been claimed.
- 2 — they have voted and the reward has already been claimed.
status reads without changing anything. claim marks the reward as given, so call it once, after you have handed it over.
The callback, if you want one
Set a callback URL on your dashboard and we fetch it the moment somebody votes, with username and userip as query parameters. It is a convenience, not the mechanism — if it fails we record the failure and the vote still stands, and your plugin will still see a 1 from status.
Limits and keys
120 requests a minute per key. A player can vote for one cluster once every 24 hours, counted by address as well as by name, so retyping a different name does not buy another vote.
The key is a credential. If it leaks, regenerate it on your dashboard — the old one stops working immediately, with no grace period, because a grace period on a leaked credential is the opposite of what regenerating is for.
Voting is free and always will be. It is not a paid feature and there is no tier that changes any of the above.
What a vote counts toward
Every vote fires your callback and satisfies status, whether or not the player has an account here — your reward should reach them either way. Only votes from signed-in players count toward the public vote ranking, because a leaderboard anybody can inflate with a made-up name measures nothing.
Your dashboard shows both numbers, labelled, so you can see rewards handed out separately from ranking position.
Getting a key
Claim your cluster and the key is on your dashboard. Claiming is free and takes one edit to your server name.