RanQed API Documentation

Connect your RSPS to Ranqed for live player tracking and automated vote rewards.

Server Heartbeat

Send a heartbeat every 60 seconds to update your live player count.

POST /api/servers/status

{
  "apiKey": "YOUR_API_KEY",
  "players": 127
}

Check Pending Votes

Check whether a player has an available vote reward.

POST /api/votes/pending

{
  "apiKey": "YOUR_API_KEY",
  "username": "PlayerName"
}

{
  "success": true,
  "hasVote": true,
  "pendingVotes": 1
}

Claim Vote Reward

Mark a vote as claimed after rewarding the player in-game.

POST /api/votes/claim

{
  "apiKey": "YOUR_API_KEY",
  "username": "PlayerName"
}

{
  "success": true,
  "claimed": true,
  "voteId": 123
}

Java RSPS Example

// Check vote when player logs in

POST /api/votes/pending

{
  "apiKey": "YOUR_API_KEY",
  "username": player.getUsername()
}


// If hasVote == true
// Give reward

POST /api/votes/claim