Présentation & Utilisation
Bienvenue sur la documentation de l'API officielle de GloryBot. Celle-ci est entièrement publique mais nécessite un "token". Elle a été créée par ToStam.
- Toute utilisateur de cette API accepte de mettre publiquement accès aux utilisateur utilisant ces données sur votre service le lien du serveur Discord support de GloryBot ou l'invitation du robot ainsi que son nom, soit "GloryBot".
- Chaque token distribué doit être utilisé uniquement par la personne possedant le token. Il est interdit de le divulgé publiquement.
- Il est interdit d'utiliser massivement l'API en "spammant".
Toutes pratiques ne respectant pas ces règles se vera son token supprimé ainsi qu'un blacklist du robot "GloryBot".
Endpoints
/api/colonie
Methode : GET
Description : Colonies les plus rentables
Paramètre : serveur
(obligatoire)
Exemple de réponse :
Le paramètre "serveur" correspond au serveur avec lequel vous souhaitez avoir la liste des colonies et leur rentabilité.[ { "name": "country1", "level": LEVEL1, "bourse": NOTATION_MONEY1, "argent": TAXE_COLONIE_MONEY1, "pourcentage": PORCENT1 }, { "name": "country2", "level": LEVEL2, "bourse": NOTATION_MONEY2, "argent": TAXE_COLONIE_MONEY2, "pourcentage": PORCENT2 } ]
/api/empire
Methode : GET
Description : Affiche la liste des colonies des empires
Paramètre : serveur
(obligatoire)
Exemple de réponse :
Le paramètre "serveur" correspond au serveur sur lequel vous souhaitez avoir la liste des empires et leurs colonies.[ { "empire": "EMPIRE", "colonie": [ "COLONIE1", "COLONIE2", "COLONIE3" ] }, ]
/api/disband
Methode : GET
Description : Pays soumit aux disbands
Paramètre : serveur
(obligatoire)
Exemple de réponse :
Le paramètre "serveur" correspond au serveur avec lequel vous souhaitez avoir la liste des pays soumis aux disbands ainsi que la raison.[ { "name": "country1", "color": "server", "reason": "inactivity" }, { "name": "country2", "color": "server", "reason": "member" }, { "name": "country2", "color": "server", "reason": "fhome" } ]
/api/souspower
Methode : GET
Description : Pays en sous-power
Paramètre : serveur
(obligatoire)
Exemple de réponse :
Le paramètre "serveur" correspond au serveur avec lequel vous souhaitez avoir la liste des pays dit en "sous-power", c'est à dire, les pays
qui ont plus de territoire que de power.[ { "name": "country1", "fhome": [ "X", "Y", "Z" ], "claimsNonValides": NUMBER, "color": "server" }, { "name": "country2", "fhome": [ "0", "0", "0" ], "claimsNonValides": NUMBER, "color": "server" }, { "name": "country3", "fhome": [ "" ], "claimsNonValides": NUMBER, "color": "server" } ]
/api/pays
Methode : GET
Description : Affiche les informations d'un pays
Paramètres : serveur
(obligatoire), pays
(obligatoire)
Exemple de réponse :
Le paramètre "serveur" correspond au serveur du pays
Le paramètre "pays" correspond pays à observer{ "nom": "NOM", "nom_pays": "NOM_PAYS", "nom_empire": "NOM_EMPIRE", "serveur": "SERVEUR", "type_serveur": "JAVA OU BEDROCK", "date_creation": TIMESTAMP_CREATION, "description": "DESCRIPTION", "banque": ARGENT_BANQUE, "drapeau": "http://73314.site.bot-hosting.net/api/drapeau?serveur=SERVEUR&pays=PAYS", "fhome": [ "X", "Y", "Z" ], "chef": "CHEF", "officier": [ "OFFICIER1", "OFFICIER2" ], "membre": [ "MEMBRE1", "MEMBRE2" ], "recrue": [ "RECRUE1", "RECRUE2" ], "nombre_membres": NB_MEMBRE, "power": POWER, "maxpower": MAXPOWER, "claim": CLAIM, "coordonnee_Terre": false, "coordonnee_Lune": false, "coordonnee_Mars": false, "coordonnee_Edora": false, "marge": MARGE_POWER_CLAIM, "mmr": MMR, "niveau": NIVEAU, "allie": [ "Allie1", "Allie2" ], "ennemi": [ "Armenie", "Malaisie", "Birmanie" ], "colonie": [ "EmpireAutrichien" ], "assaut": { "total": NB_ASSAUT, "gagne": NB_GAGNE, "perdu": NB_PERDU, "nul": NB_NUL, "details": [ { "date": TIMESTAMP_DATE, "score": SCORE_DE_PAYS, "resultat": "défaite OU victoire", "duree": "TEMPS mins", "ennemi": "NOM_PAYS", "aide_ennemi": [ "ENNEMI1", "ENNEMI2" ], "aide_allie": [ "ALLIE1", "ALLIE2" ] } ] } }
/api/drapeau
Methode : GET
Description : Affiche le drapeau d'un pays
Paramètres : serveur
(obligatoire), pays
(obligatoire)
Exemple de réponse :
Cette route ne nécessite pas de clé d'authentification. Elle renvoie une image au format PNG.
/api/paysDisponible
Methode : GET
Description : Affiche la liste des pays disponibles à la création
Paramètre : serveur
(obligatoire)
Exemple de réponse :
Le paramètre "serveur" correspond au serveur sur lequel vous souhaitez avoir la liste des pays disponibles à la création.[ { "name": "PAYS", "x": "COORDONNEEX", "z": "COORDONNEEY" }, ]
/api/paysCree
Methode : GET
Description : Affiche la liste des pays créés
Paramètre : serveur
(obligatoire)
Exemple de réponse :
Le paramètre "serveur" correspond au serveur sur lequel vous souhaitez avoir la liste des pays créé.[ "Pays1", "Pays2", "Pays3" ]
/api/top
Methode : GET
Description : Classement des pays
Paramètres : serveur
(optionnel), type
(obligatoire)
Exemple de réponse :
Le paramètre "serveur" correspond au serveur avec lequel vous souhaitez avoir le classement des pays.
Le paramètre "type" correspond au type de classement que vous souhaitez avoir parmit "mmr", "territoire", "membre", "power", "maxpower",
"banque", "niveau", "allie", "ennemi", "colonie" et "creation".[ { "classement": CLASSEMENT_INTER_SERVEUR, "image": "IMAGE_BASE_64", "entreprise": "NOM_ENTREPRISE", "type": "TYPE", "salaries": NB_SALARIES, "chiffreaffaire": CHIFFRE_D_AFFAIRE, "serveur": "SERVEUR" }, { "classement": CLASSEMENT_INTER_SERVEUR, "joueur": "PSEUDONYME", "gains": GAIN, "dernierLancee": "YYYY-MM-JJ HH:MM:SS", "serveur": "SERVEUR" }, { "classement": CLASSEMENT_INTER_SERVEUR, "pays": "NOM_PAYS", "kills": KILLS, "morts": MORTS, "captures": CAPTURE, "points": POINTS, "serveur": "SERVEUR" }, { "classement": CLASSEMENT_INTER_SERVEUR, "pseudo": "PSEUDO", "kills": KILLS, "morts": MORTS, "ratio": RATIO } ]
/api/classement
Methode : GET
Description : Classement du site
Paramètres : type
(obligatoire), serveur
(optionnel), limite
(optionnel)
Exemple de réponse :
Le paramètre "serveur" correspond au serveur avec lequel vous souhaitez avoir le classement.
Le paramètre "type" correspond au type de classement que vous souhaitez avoir parmit "warzoneJoueur", "warzonePays", "machineASous"
et "entreprise".
Le paramètre "limite" correspond au nombre d'informations que vous souhaitez afficher.Aucun exemple n'est disponible pour cette route actuellement.
/api/serveur
Methode : GET
Description : Information d'un serveur
Paramètre : serveur
(obligatoire)
Exemple de réponse :
Le paramètre "serveur" correspond au serveur avec lequel vous souhaitez avoir des informations.[ { "paysCrees": INTEGER, "paysDisponibles": INTEGER, "dateCreation": "STRING", "sousPower": INTEGER, "disbands": INTEGER, "description": "STRING", "discord": "STRING", "youtube": "STRING", "twitter": "STRING", "journal": "STRING", "resumeonu": "STRING", "staff": { "administrateur": [ "ADMIN1", "ADMIN2" ], "super_moderateur": [ "SUPERMODO1", "SUPERMODO2" ], "moderateur_plus": [ "MODOPLUS1", "MODOPLUS2" ], "moderateur": [ "MODO1", "MODO2" ], "moderateur_test": [ "MODOTEST1", "MODOTEST2" ], "guide": [ "GUIDE1", "GUIDE2" ] } } ]
/api/logo
Methode : GET
Description : Affiche le logo du serveur
Paramètre : serveur
(obligatoire)
Exemple de réponse :
Le paramètre "serveur" correspond au serveur auquel vous souhaitez optenir le logo parmit cette liste :
- blue
- orange
- yellow
- white
- black
- cyan
- lime
- coral
- pink
- purple
- green
- red
- mocha
- alpha
- sigma
- omega
- delta
- epsilon
- ruby
- gamma
- radio1
- radio2
- radio3
Cette route ne nécessite pas de clé d'authentification. Elle renvoie une image au format PNG.
/api/banniere
Methode : GET
Description : Affiche la bannière du serveur
Paramètre : serveur
(obligatoire)
Exemple de réponse :
Le paramètre "serveur" correspond au serveur auquel vous souhaitez optenir la bannière parmit cette liste :
- blue
- orange
- yellow
- white
- black
- cyan
- lime
- coral
- pink
- purple
- green
- red
- mocha
- alpha
- sigma
- omega
- delta
- epsilon
- ruby
- gamma
Cette route ne nécessite pas de clé d'authentification. Elle renvoie une image au format PNG.
/api/joueurConnecte
Methode : GET
Description : Liste les joueurs et le nombre de joueur connectés
Paramètre : serveur
(obligatoire)
Exemple de réponse :
Le paramètre "serveur" correspond au serveur sur lequel vous souhaitez obtenir la liste et le nombre de joueur connectés[ { "update": DERNIERE_MISE_A_JOUR, "nombre": NOMBRE_DE_JOUEUR_CONNECTE, "joueur": [ "JOUEUR1", "JOUEUR2", "JOUEUR3", ] } ]
/api/joueur
Methode : GET
Description : Liste les joueurs semblables à la recherche
Paramètre : joueur
(obligatoire)
Exemple de réponse :
Le paramètre "joueur" correspond au début ou le pseudonyme complet de la personne que vous cherchez.[ { "pseudonyme": "PSEUDONYME", "tete": "https://skins.nationsglory.fr/face/PSEUDONYME/15", "tete3d": "https://skins.nationsglory.fr/face/tPSEUDONYME/3d/15", "corp": "https://skins.nationsglory.fr/body/PSEUDONYME/15", "corp3d": "https://skins.nationsglory.fr/body/PSEUDONYME/3d/15", "skin": "https://skins.nationsglory.fr/PSEUDONYME" } ]
/api/NGRadio
Methode : GET
Description : Affiche les informations de la NGRadio
Exemple de réponse :
Aucun exemple n'est disponible pour cette route actuellement.
/api/stats
Methode : GET
Description : Affiche les statistiques du robot
Exemple de réponse :
Cette route ne nécessite pas de clé d'authentification.{ "serveur": NB_SERVEUR, "membre": NB_MEMBRE, "commande": NB_COMMANDEs }
/api/tokenStats
Methode : GET
Description : Affiche tes statistiques de requête
Exemple de réponse :
{
"mois1": NB_REQUETE_MOIS_1,
"mois2": NB_REQUETE_MOIS_2
}
/api/notationWeek
Methode : GET
Description : Affiche le numéro de la semaine en cours
Exemple de réponse :
{
"semaine":"STRING"
}
/api/historiqueStaff
Methode : GET
Description : Affiche l'historique des grades staffs d'une personne
Paramètre : staff
(obligatoire), serveur
(optionnel), date
(optionnel)
Exemple de réponse :
Le paramètre "staff" correspond au pseudonyme exact du staff.
Le paramètre "serveur" correspond au serveur unique à afficher.
Le paramètre "date" correspond au grade qu'avait la personne à cette date précise sous la forme "JJ-MM-AAAA".{ "DATE": { "serveur": "SERVEUR", "grade": "GRADE" } }
/api/doubleLead
Methode : GET
Description : Affiche l'a liste des joueurs en double lead ainsi que leurs serveurs et leurs pays
Paramètre : serveur
(optionnel)
Exemple de réponse :
Le paramètre "serveur" correspond aux joueurs en double lead qui ont un pays dans ce serveur.Aucun exemple n'est disponible pour cette route actuellement.