app logoYoxo

Documentation de l'API data de Yoxo

Obtenir ma clé api

Routes API

GET /api/data/discordPlayer

Description:
Cette route permet d'avoir une correspondance entre un pseudo en jeux et le pseudo discord du joueurs. Les données ne sont pas executives et peuvent être erronées. Essayer de croiser les données obtenus avec d'autres sources.

Paramètres de requête:

  • player (optionnel) : Le pseudo du joueurs partiel ou complet du joueurs que vous souhaité rechercher (minimum 3 caractères)
  • discord (optionnel) : L'identifiant discord, le pseudonyme discord ou l'id discord partiel ou total du joueurs que vous souhaité rechercher (minimum 3 caractères)
  • absolute (optionnel) : Permet de définir si la recherche doit être exacte ou non. Par défaut, la recherche est non exacte. (Retourne tous les résultats contenant la recherche)

Exemple de requête

GET /api/data/discordPlayer?player=Romaindu35&absolute=true

Réponse

[
    {
        "player": "Romaindu35",
        "discord": "romaindu35",
        "discordId": "683744759814160385",
        "discordUsername": "Romaindu35",
        "updatedAt": "2024-10-30T13:01:11.645Z"
    }
]

POST /api/data/discordPlayer

Description:
Cette route est équivalent à la route GET /api/data/discordPlayer mais permet de rechercher plusieurs joueurs en une seule requête. Pour des raison pratique, nous ne retournerons que les résultats absolue.

Paramètres de requête:

  • player (optionnel) : Un tableau de pseudo complet des joueurs que vous souhaité rechercher (minimum 3 caractères)
  • discord (optionnel) : Un tableau d'identifiant discord, de pseudonyme discord ou d'id discord total des joueurs que vous souhaité rechercher (minimum 3 caractères)

Exemple de requête

POST /api/data/discordPlayer
Body data: {"player": ["Romaindu35", "UnAutre"]}

Réponse

[
    {
        "player": "Romaindu35",
        "discord": "romaindu35",
        "discordId": "683744759814160385",
        "discordUsername": "Romaindu35",
        "updatedAt": "2024-10-30T13:01:11.645Z"
    },
    {
        "player": "UnAutre",
        "discord": "autre1",
        "discordId": "683744759814160387",
        "discordUsername": "UnAutre",
        "updatedAt": "2024-10-31T13:01:11.645Z"
    }
]

GET /api/data/connectedPlayers

Description:
Cette route permet de récupérer le nombre de joueurs connectés sur les serveurs de NationsGlory. Les données sont issues de nos données. Si aucune données n'est disponible, une erreur 503 sera retourné

Paramètres de requête:

  • server (obligatoire) : Le serveur dont vous souhaitez récupérer les joueurs connectés. Les serveurs disponibles sont les suivants : blue, orange, yellow, white, black, cyan, lime, coral, pink, purple, green, red, ruby, mocha.

Exemple de requête

GET /api/data/connectedPlayers?server=red

Réponse

TODO

GET /api/data/banner/[banner]

Description:
Cette route permet de récupérer une bannière en fonction de son nom. Tous droit d'auteur des images réservé à NationsGlory.

Paramètres de requête:

  • banner (obligatoire) : Le nom de la bannière que vous souhaitez récupérer. Les bannières disponibles sont les suivantes : joueur, joueur_prime, ngprime, heros, heros_prime, legende, legende_prime, premium, premium_prime, affiliate, affiliate_prime, staff, staff_prime, moderateur_test, moderateur_test_prime, moderateur, moderateur_prime, moderateur_plus, moderateur_plus_prime, supermodo, supermodo_prime, guide, guide_prime, builder, builder_prime, admin, admin_prime, comm, comm_prime, radio, radio_prime, dev, respdesign, respadmin, respstaff, respgameplay, co-fonda, fondateur, rp, rp_prime, info, onu, event, atm, loto, mine, trade, announce, assault, shop, minus, plus, journaliste, journalist, avocat, player_en, player_prime_en, ngprime_en, heros_en, heros_prime_en, legende_en, legende_prime_en, premium_en, premium_prime_en, affiliate_en, affiliate_en_prime, staff_en, staff_en_prime, mod_test_en, mod_test_en_prime, mod_en, mod_en_prime, mod_plus_en, mod_plus_en_prime, supermod_en, supermod_en_prime, guide_en, guide_en_prime, builder_en, builder_en_prime, admin_en, admin_en_prime, dev_en, commmanager_en, adminmanager_en, staffmanager_en, gameplaymanager_en, co-founder_en, founder_en, rp_en, rp_prime_en, info_en, un_en, event_en, atm_en, loto_en, mine_en, trade_en, announce_en, assault_en, shop_en, minus_en, plus_en, journalist_en, lawyer_en.

Exemple de requête

GET /api/data/banner/joueur

Réponse

Une image au format png

GET /api/data/flag/[flag]

Description:
Cette route permet de récupérer un drapeau en fonction de son nom. Les drapeaux sont issues du site suivant: "https://www.drapeauxdespays.fr/"

Paramètres de requête:

  • flag (obligatoire) : Le nom du drapeau que vous souhaitez récupérer. Il se peut que certains drapeaux ne soient pas disponibles. Dans ce cas, un drapeau blanc sera retourné

Exemple de requête

GET /api/data/flag/france

Réponse

Une image au format png

GET /api/data/logo/[logo]

Description:
Cette route permet de récupérer les logos des serveurs NationsGlory. Tous droit d'auteur des images réservé à NationsGlory.

Paramètres de requête:

  • logo (obligatoire) : Le nom du logo que vous souhaitez récupérer. Les logos disponibles sont les suivants : alpha, black, blue, coral, cyan, delta, epsilon, gamma, green, lime, mocha, ng, omega, orange, pink, purple, red, ruby, sigma, white, yellow.

Exemple de requête

GET /api/data/logo/ng

Réponse

Une image au format png

GET /api/data/emote/[emote]

Description:
Cette route permet de récupérer les émotes de chat de NationsGlory. Tous droit d'auteur des images réservé à NationsGlory.

Paramètres de requête:

  • emote (obligatoire) : Le nom de l'émote que vous souhaitez récupérer. Les émotes disponibles sont les suivantes : 4head, ah, babyrage, bcwarrior, biblethump, blessrng, brokeback, cmonbruh, coolstorybob, dansgame, failfish, heyguys, issou, issouserious, kappa, kappahd, kawau, kreygasm, lul, minglee, ng, notlikethis, opieop, pogchamp, residentsleeper, seemsgood, wutface.

Exemple de requête

GET /api/data/emote/heyguys

Réponse

Une image au format png

GET /api/data/serverStaff

Description:
Cette route permet de récupérer la liste des staffs d'un serveur. Les données sont issues de l'API GloryBot.

Paramètres de requête:

  • server (obligatoire) : Le serveur dont vous souhaitez récupérer les staffs. Les serveurs disponibles sont les suivants : blue, orange, yellow, white, black, cyan, lime, coral, pink, purple, green, red, ruby, mocha.

Exemple de requête

GET /api/data/serverStaff?server=red

Réponse

[
    ["player1", "admin"],
    ["player2", "supermodo"]
]