Top Metin2
2024 Metin2 private servers
Advertising Campaign

Documentation

Français

Vote IP

Le joueur vote sur notre plateforme et vous pouvez ainsi le récompenser à l'issu de ce vote. Pour cela, votre joueur doit se rendre sur votre site internet pour déclencher l'appel de notre API. La réponse de notre API est un tableau JSON.
  • Vous permet de vérifier un vote à l'aide d'une adresse IP
  • API compatible avec le protocole IPv4 et IPv6

URL de Vote

Vous devez définir au sein de votre site internet, un lien de vote pour votre joueur. Ce lien doit impérativement contenir l'ID de votre serveur de jeu.
  • Exemple : https://metin2.top/in/game-id-game-seo-name/

API

Route https://metin2.top/api/verify/key/ip/

Paramètres

Champ Type Description
key string Clé secrète de votre serveur de jeu
ip string Adresse IP de votre joueur

Réponses

Status Header Response Data
true 200 Player has voted - Verified vote Date and time of the vote in datetime format
false 101 IP address is invalid NULL
false 102 IP address or ASN is not safe NULL
false 103 API Key does not exist NULL
false 104 Wrong API Called NULL
false 105 Game server banned NULL
false 106 Game server disabled NULL
false 107 Vote has already been verified by our API Date and time of the vote verification in datetime format
false 108 Player vote does not exist NULL
Notre API possède deux statut principaux :
  • Booléen (vrai) ⇒ Le vote a été vérifié, vous pouvez récompenser votre joueur
  • Booléen (faux) ⇒ Une erreur est survenue lors de la vérification du vote
Si votre joueur à voté, vous pouvez le récompenser, dans le cas contraire, la variable response contient l'éventuel message d'erreur. Notre API contient d'autres variables vous permettant de cibler les anomalies et les raisons pour laquelle notre API décline une requête.

Exemple

HTTP/1.1 200 OK
{
	'status'   => true,
	'header'   => 200,
	'response' => "Player has voted - Verified vote"
	'data'     => "31-12-9999 23:59:59"
}

Exemple PHP

Vous devez installer le script de notre API sur l'une de vos pages sur votre site internet. Il doit être installé sur une zone sécurisée, c'est-à-dire, une page ou votre joueur doit être connecté à votre site internet pour consulter et accéder à la dite page. Notre API, vous permet de récompenser votre joueur pour avoir effectué un vote pour votre serveur de jeu au sein de notre plateforme, pour cela, vous devez adapter et ajouter le script de votre récompense. 
<?php

    $key = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
    // Clé secrète de votre serveur de jeu

    $ip = isset($_SERVER["HTTP_CF_CONNECTING_IP"]) ? $_SERVER["HTTP_CF_CONNECTING_IP"] : $_SERVER['REMOTE_ADDR'];
    // Récupére l'adresse IP de votre joueur

    $api = "https://metin2.top/api/verify/{$key}/{$ip}/";
    // Route

    $response = @file_get_contents($api);
    // Appel de l'API

    $vote = json_decode($response);
    // Décodage de la réponse

    if ($vote->status){

        // Vote OK
        // Vous pouvez donner les monnaies virtuelles
    } else {

        // [OU] Le vote a déjà été vérifié
        // [OU] Aucun vote n'a été trouvé
        // [OU] Une erreur est survenue
    }
?>
Top Metin2