Metin2 P-Server API
Interface para administradores de servidores: consultar o estado do voto e atribuir recompensas automaticamente.
Verificação do voto
Para verificar se um utilizador já votou, é preciso chamar a seguinte ligação:
https://www.metin2pserver.to/api/{SERVERNAME}/{USERID}
Explicação:
- {SERVERNAME}: O nome do servidor em que o utilizador votou.
- {USERID}: O ID da conta de utilizador na base de dados do servidor.
A API devolve um valor true ou false para indicar se o utilizador já votou e tem, por isso, direito a uma recompensa.
Efetuar o voto
Para efetuar um voto, os utilizadores têm de usar a seguinte ligação:
https://www.metin2pserver.to/vote-{SERVERNAME}.htm/{USERID}
Explicação:
- {SERVERNAME}: O nome do servidor que aparece na top lista.
- {USERID}: O ID da conta de utilizador na base de dados do servidor que votou.
Código PHP de exemplo
// API-URL und Parameter definieren
$serverName = 'PserverName';
$userId = 12345;
$apiUrl = 'https://www.metin2pserver.to/api/' . $serverName . '/' . $userId;
// cURL-Session starten
$ch = curl_init();
// cURL-Optionen setzen
curl_setopt($ch, CURLOPT_URL, $apiUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // Antwort zurückgeben als String
curl_setopt($ch, CURLOPT_TIMEOUT, 30); // Timeout auf 30 Sekunden setzen
// API-Anfrage ausführen
$response = curl_exec($ch);
// cURL-Fehler überprüfen
if (curl_errno($ch)) {
echo 'cURL Error: ' . curl_error($ch);
} else {
// Antwort dekodieren
$data = json_decode($response, true);
// Überprüfen, ob der Nutzer bereits abgestimmt hat
if ($data['status'] === true) {
echo 'Abstimmung erfolgreich durchgeführt!';
} else {
echo 'Es gab ein Problem mit der Abstimmung.';
}
}
// cURL schließen
curl_close($ch);
Explicação do código de exemplo:
- $serverName: O nome do servidor consultado no URL.
- $userId: O ID do utilizador cujo estado de voto é verificado.
- $apiUrl: O URL completo da API, gerado com os parâmetros para o nome do servidor e o ID do utilizador.
- cURL: Uma ferramenta PHP para enviar pedidos HTTP e alcançar a API.
- json_decode($response, true): A resposta da API é recebida como JSON e convertida num array PHP.
- if ($data['status'] === true): Verifica se o utilizador já votou.