Documentation APIs
API de vote
Vous permet de vérifier qu'un utilisateur a voté pour votre serveur au cours des 90 dernières minutes
Endpoint | https://serveur-prive.net/api/v1/servers/{server_token}/votes/{user_ip} |
{server_token} | Indiquez le Token associé à votre serveur. Vous pouvez le trouver depuis l'onglet 'Paramètres' |
{user_ip} | Indiquez l'adresse IP à vérifier. Vous pouvez spécifier une adresse IPV4 et IPV6 |
Exemple de code
<?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->is_connected; // Correspond à l'état de connexion de l'utilisateur
$datas->is_subscriber; // Correspond à l'état d'abonnement de l'utilisateur
$datas->next_vote_seconds; // Correspond au nombre de secondes restantes avant que l'utilisateur puisse à nouveau voter
} else {
echo 'Pas ou déjà voté';
}
?>
Exemple de réponse
{
"success": true,
"data": {
"username": "Trevor",
"voted_at": 1689241974,
"next_vote_seconds": 5395,
"is_connected": true,
"is_subscriber": false
}
}
API de statistiques
Vous permet de récupérer les données de votre serveur comme sa position, son nombre de votes etc.
Endpoint | https://serveur-prive.net/api/v1/servers/{server_token}/statistics |
{server_token} | Indiquez le Token associé à votre serveur. Vous pouvez le trouver depuis l'onglet 'Paramètres' |
Exemple de code
<?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';
}
?>
Exemple de réponse
{
"success": true,
"data": {
"position": 12,
"votes_count": 1202,
"clicks_count": 287,
"comments_count": 7,
"rating": 5
}
}
API donateurs
Vous permet de récupérer les utilisateurs qui ont fait un don pour votre serveur depuis la page donation
Endpoint | https://serveur-prive.net/api/v1/servers/{server_token}/donors |
{server_token} | Indiquez le Token associé à votre serveur. Vous pouvez le trouver depuis l'onglet 'Paramètres' |
Exemple de code
<?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';
}
?>
Exemple de réponse
{
"success": true,
"data": [{
"username": "Trevor",
"avatar": "url",
"amount": 10,
"message": "Message...",
"currency": "eur",
"created_at": 1689241974
}]
}
API abonnements
API pour récupérer les utilisateurs qui se sont abonnés à votre serveur depuis la page de vote
Endpoint | https://serveur-prive.net/api/v1/servers/{server_token}/subscribers |
{server_token} | Indiquez le Token associé à votre serveur. Vous pouvez le trouver depuis l'onglet 'Paramètres' |
Exemple de code
<?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';
}
?>
Exemple de réponse
{
"success": true,
"data": [{
"username": "Trevor",
"avatar": "url",
"started_at": 1689241974,
"ended_at": 1689241974
}]
}
API Top voteurs
Vous permet de récupérer la liste des utilisateurs qui ont voté pour votre serveur au cours du mois
Endpoint | https://serveur-prive.net/api/v1/servers/{server_token}/voters |
{server_token} | Indiquez le Token associé à votre serveur. Vous pouvez le trouver depuis l'onglet 'Paramètres' |
Exemple de code
<?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/voters");
$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->position; // Correspond à la position du serveur dans le classement du mois
$data->votes; // Correspond au nombre de votes du joueur
$data->avatar; // Correspond à l'avatar du donateur ou de l'abonné
$data->subscribed; // Correspond au statut d'abonnement du joueur
$data->public_profile; // Correspond à l'URL de la page publique du joueur
}
} else {
echo 'Le Token spécifié est incorrect';
}
?>
Exemple de réponse
{
"success": true,
"data": [{
"username": "Trevor",
"position": 1,
"votes": 10,
"avatar": "url",
"subscribed": true,
"public_profile": "url",
}]
}