API Documentation
Integrate voting functionality into your Metin2 server
Quick Navigation
Overview
Our API allows you to integrate voting functionality directly into your Metin2 server. Players can vote and receive rewards automatically through simple HTTP requests.
Key Features
- • Check if a player has voted in the last 24 hours
- • Process votes and track player voting history
- • Automatic vote validation and fraud protection
- • Premium server benefits (vote multipliers)
Base URL
https://pservers.top/api/v1/
All API requests should be made to this base URL.
Check Vote Status
Check if a player can vote or is still in cooldown period.
/check-vote
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | integer | Yes | Your server ID |
| name | string | Yes | Player character name |
Example Request
GET https://pservers.top/api/v1/check-vote?id=123&name=PlayerName
Example Response
{
"status": "success",
"code": 200,
"can_vote": true,
"message": "No vote found, player can vote now",
"previous_votes": 5,
"cooldown": 0
}
Process Vote
Submit a vote for a player and receive confirmation.
/vote
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | integer | Yes | Your server ID |
| name | string | Yes | Player character name |
Example Request
GET https://pservers.top/api/v1/vote?id=123&name=PlayerName
Example Response
{
"status": "success",
"code": 200,
"message": "Vote recorded successfully",
"vote_id": 456789,
"vote_value": 1,
"new_count": 1337
}
Response Codes
| Code | Status | Description |
|---|---|---|
| 200 | Success | Request completed successfully |
| 400 | Bad Request | Missing required parameters |
| 403 | Forbidden | Server suspended or vote rejected |
| 404 | Not Found | Server not found |
| 429 | Too Many Requests | Player in cooldown period |
| 500 | Server Error | Internal server error |
Rate Limits
Vote Cooldown
Players can vote once every 24 hours per server.
API Rate Limit
300 requests per hour per IP address.
Need Help?
If you encounter any issues, feel free to reach out on Discord