Metin2 P-Server API
Schnittstelle für Serverbetreiber: Vote-Status abfragen und Belohnungen automatisch vergeben.
Überprüfung der Abstimmung
Um zu überprüfen, ob ein Nutzer bereits abgestimmt hat, muss der folgende Link aufgerufen werden:
https://www.metin2pserver.to/api/{SERVERNAME}/{USERID}
Erklärung:
- {SERVERNAME}: Der Name des Servers, auf dem der Nutzer abgestimmt hat.
- {USERID}: Die ID des Nutzerkontos in der Serverdatenbank.
Die API gibt einen Wert von true oder false zurück, um anzuzeigen, ob der Nutzer bereits abgestimmt hat und somit Anspruch auf eine Belohnung hat.
Abstimmung vornehmen
Um eine Abstimmung durchzuführen, müssen die Nutzer den folgenden Link verwenden:
https://www.metin2pserver.to/vote-{SERVERNAME}.htm/{USERID}
Erklärung:
- {SERVERNAME}: Der Name des Servers, der in der Topliste auftaucht.
- {USERID}: Die ID des Nutzerkontos in der Serverdatenbank, das abgestimmt hat.
PHP Beispielcode
// 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);
Erklärung des Beispielcodes:
- $serverName: Der Name des Servers, der in der URL abgefragt wird.
- $userId: Die ID des Nutzers, dessen Abstimmungsstatus überprüft wird.
- $apiUrl: Die vollständige API-URL, die mit den Parametern für den Servernamen und die Nutzer-ID generiert wird.
- cURL: Ein PHP-Tool, um HTTP-Anfragen zu senden und die API zu erreichen.
- json_decode($response, true): Die Antwort der API wird als JSON empfangen und in ein PHP-Array umgewandelt.
- if ($data['status'] === true): Überprüft, ob der Nutzer bereits abgestimmt hat.