Endpoint

https://epictop100.com/api/public/vote-status

• Method: GET or POST
• Auth: api_key parameter
• Required params: api_key, server_id
• Optional param: ip (if omitted, API uses requester IP).

Request examples

GET

curl -X GET "https://epictop100.com/api/public/vote-status?api_key={API-KEY}&server_id={SERVER-ID}&ip={PLAYER-IP}"

POST

curl -X POST "https://epictop100.com/api/public/vote-status" \
 -H "Content-Type: application/json" \
 -d '{"api_key":"{API-KEY}","server_id":123,"ip":"203.0.113.10"}'

Success response

{
 "website_name": "EpicTop100",
 "voteTime": 1712345678,
 "serverTime": 1712349278,
 "isVoted": true,
 "voter_ip": "192.168.1.100",
 "server_name": "L2 Song of War",
 "server_votes": 1523,
 "server_visits": 6564,
 "server_rank": 20,
 "next_rank": 19,
 "next_rank_votes": 50
}

Error response example

{
 "ok": false,
 "reason": "rate_limited",
 "message": "Rate limit exceeded for this API key."
}

Common reasons: invalid_request, invalid_api_key, server_not_found, rate_limited.

Notes

• Each user account has one API key; rotating invalidates the old key.
• Only servers owned by the API key owner can be queried.
• Keep your API key on your server backend. Rotate immediately if leaked.