Documentation APIs

API de vote

L'API de vote permet de vérifier qu'un utilisateur a voté pour votre serveur

<?php
$server_token = "Token de votre serveur"; // Remplacez "TOKEN" par le token de votre serveur.
$user_ip = isset($_SERVER["HTTP_CF_CONNECTING_IP"])
    ? htmlentities($_SERVER["HTTP_CF_CONNECTING_IP"])
    : htmlentities($_SERVER["REMOTE_ADDR"]); // Adresse IP de l'utilisateur
$json = file_get_contents("https://serveur-prive.net/api/v1/servers/$server_token/votes/$user_ip");
$json_data = json_decode($json);
if ($json_data->success) {
    echo 'Vous avez bien voté';
    // Vous pouvez utiliser les variables suivantes :
    $datas = $json_data->data; // Cette variable contiendra les données JSON renvoyées par l'API.
    $datas->username; // Pseudonyme de l'utilisateur
    $datas->voted_at; // Correspond à la date du vote au format timestamp
    $datas->next_vote_seconds; // Correspond au nombre de secondes restantes avant que l'utilisateur puisse à nouveau voter
} else {
    echo 'Pas ou déjà voté';
}
?>

Si "success" = true

{
    "success":true,
    "data":{
        "username":"Trevor",
        "voted_at":1689241974,
        "next_vote_seconds":5395
    }
}

Si "success" = false

{
    "success":false,
    "message":"Message..."
}

API statistiques

API de statistiques pour récupérer les données de votre serveur (position, clics, votes, commentaires et la note)

<?php
$server_token = "Token de votre serveur"; // Remplacez "TOKEN" par le token de votre serveur.
$json = file_get_contents("https://serveur-prive.net/api/v1/servers/$server_token/statistics");
$json_data = json_decode($json);
if ($json_data->success) {
    echo 'Serveur trouvé';
    // Vous pouvez utiliser les variables suivantes :
    $datas = $json_data->data; // Cette variable contiendra les données JSON renvoyées par l'API.
    $datas->position; // Correspond à la position du serveur dans le classement du mois
    $datas->votes_count; // Correspond au nombre de votes du serveur
    $datas->clicks_count; // Correspond au nombre de clics du serveur
    $datas->comments_count; // Correspond au nombre de commentaires du serveur
    $datas->rating; // Correspond à la note du serveur sur 5
} else {
    echo 'Le Token spécifié est incorrect';
}
?>

Si "success" = true

{
    "success":true,
    "data":{
        "position":12,
        "votes_count":1202,
        "clicks_count":287,
        "comments_count":7,
        "rating":5
    }
}

Si "success" = false

{
    "success":false,
    "message":"Message..."
}

API donateurs

API pour récupérer les utilisateurs qui ont fait un don pour votre serveur depuis la page donation

<?php
$server_token = "Token de votre serveur"; // Remplacez "TOKEN" par le token de votre serveur.
$json = file_get_contents("https://serveur-prive.net/api/v1/servers/$server_token/donors");
$json_data = json_decode($json);
if ($json_data->success) {
    echo 'Serveur trouvé';
    // Vous pouvez utiliser les variables suivantes :
    $datas = $json_data->data; // Cette variable contiendra les données JSON renvoyées par l'API.
    foreach($datas as $data) {
        $data->username; // Pseudonyme de l'utilisateur
        $data->avatar; // Correspond à l'avatar du donateur ou de l'abonné
        $data->amount; // Correspond au montant du don
        $data->message; // Correspond au message du donateur
        $data->currency; // Correspond à la devise du don
        $data->created_at; // Correspond à la date du don au format timestamp
    }
} else {
    echo 'Le Token spécifié est incorrect';
}
?>

Si "success" = true

{
    "success":true,
    "data":[{
        "username":"Trevor",
        "avatar":"url",
        "amount":10,
        "message":"Si "success" = true",
        "currency":"eur",
        "created_at":1689241974
    }]
}

Si "success" = false

{
    "success":false,
    "message":"Message..."
}

API abonnés

API pour récupérer les utilisateurs qui se sont abonnés à votre serveur depuis la page de vote

<?php
$server_token = "Token de votre serveur"; // Remplacez "TOKEN" par le token de votre serveur.
$json = file_get_contents("https://serveur-prive.net/api/v1/servers/$server_token/subscribers");
$json_data = json_decode($json);
if ($json_data->success) {
    echo 'Serveur trouvé';
    // Vous pouvez utiliser les variables suivantes :
    $datas = $json_data->data; // Cette variable contiendra les données JSON renvoyées par l'API.
    foreach($datas as $data) {
        $data->username; // Pseudonyme de l'utilisateur
        $data->avatar; // Correspond à l'avatar du donateur ou de l'abonné
        $data->started_at; // Correspond à la date de début de l'abonnement au format timestamp
        $data->ended_at; // Correspond à la date de fin de l'abonnement au format timestamp
    }
} else {
    echo 'Le Token spécifié est incorrect';
}
?>

Si "success" = true

{
    "success":true,
    "data":[{
        "username":"Trevor",
        "avatar":"url",
        "started_at":1689241974,
        "ended_at":1689241974
    }]
}

Si "success" = false

{
    "success":false,
    "message":"Message..."
}