API Fortnite

Présentation

Fortnite API est une API sur le jeu Fortnite, avec laquelle on peut récupérer toutes sortes d'informations sur le jeu et les joueurs :)

On peut y trouver des infos sur :

Les joueurs
Les objets du jeu
Les news
Les challenges
Les leaderboards
Les PatchNotes
Le mode PVE

Voici le lien du site : https://fortniteapi.com/

Récupération du token

Pour utiliser cette API, tu as besoin d'un token :) Sinon, tu ne pourras pas récupérer les données des points d'accès !

Pour créer ton token , il te suffit de créer ton compte sur le site, et de récupérer ta clé.

Une fois ton compte créé, tu peux récupérer ta clé comme suit.

Points d'accès de l'API

Pour commencer, voici le lien de la documentation de l'API : https://documenter.getpostman.com/view/4499368/RWEjoGqD

Headers d'autorisation

Avant de commencer à parler des points d'accès, il faut d'abord parler des headers d'autorisation.

Pour utiliser cette API, il faut ajouter deux headers à notre requête :

Le premier est indiqué au début de la documentation.

Son nom doit être X-Fortnite-API-Version, et sa valeur doit être v1.1 !

Le deuxième est indiqué sous le point d'accès, et c'est simplement celui qui contient notre token :)

Son nom doit être Authorization, et sa valeur doit être ton token !

Voici un code exemple pour créer les headers ;)

User API

La partie User API contient de points d'accès :

User ID, qui permet de récupérer l'ID d'un joueur
User stats, qui permet de récupérer toutes les stats d'un joueur

Pour te montrer comment fonctionne l'API de Fortnite, on va se servir de ces deux points d'accès, libre à toi d'aller expérimenter sur les autres !

Récupérer l'User ID

Pour pouvoir se servir du point d'accès User Stats, on doit d'abord passer par celui ci pour récupérer l'ID du joueur qu'on recherche :)

Voici la description du point d'accès :

En bleu, la méthode de la requête. C'est la méthode POST qu'on utilisera partout dans cette API ;)
En vert, le lien du point d'accès
En orange, le rappel pour mettre le header d'autorisation du token
Et en violet, les paramètres ! Ici, on doit renseigner le paramètre username, qui correspond au nom d'utilisateur dont on veut récupérer l'ID :)

Tous les points d'accès suivent cette forme, alors tu ne devrais pas avoir de mal à t'y retrouver par la suite ;)

Voici un code exemple qui te montre comment créer ta requête, avec les headers ainsi que les paramètres !

Et voici le résultat JSON qui nous est renvoyé ! On voit bien l'uid qu'on voulait récupérer ;)

Récupérer les stats d'un joueur

On va se servir du point d'accès User Stats pour récupérer les stats d'un joueur.

Jetons un coup d'oeil à la documentation :

On a 3 paramètres à renseigner :

L'user ID, qu'on doit récupérer avec le point d'accès précédent.
La plateforme du joueur dont on veut récupérer les stats ('pc', 'xb1' ou 'ps4')
Le laps de temps sur lequel on veut récupérer les stats. Ça peut être 'alltime' pour les stats depuis le début, ou une saison spécifique :)

Pour pouvoir faire une requête sur ce point d'accès, on doit donc premièrement faire une requête sur User ID comme expliqué pendant la partie précédente.

Ensuite, on peut faire notre deuxième requête sur le point d'accès User Stats :)

Le code exemple Facile suit exactement cet exemple ! Vas le regarder si tu as besoin de voir comment récupérer simplement le stats d'un joueur ! ;)

Exemples

Ces codes exemples sont les différentes évolutions d'un programme consistant à récupérer les stats de joueurs de Fortnite.

Ils sont classés de la version la plus simple à la plus complexe :)

Facile - Récupérer les stats d'un joueur

Ce code récupère les stats d'un joueur donné, et les affiche en format JSON ! :)

(N'aies pas peur du nombre de lignes, en vrai il y autant de commentaires explicatifs que de code :p)

Moyen - Récupérer et traiter les stats d'un joueur

Ce code est assez similaire à l'exemple Facile, mais dans celui-ci, on ne se contente pas d'afficher les stats en JSON !

On traite les informations importantes pour faire des phrases customisées :)

Difficile - Comparer les stats de deux joueurs

Ce code récupère les stats de deux joueurs, puis les compare une par une.

Pour chaque stat, il attribue un point au joueur ayant la meilleure, et décompte les points à la fin pour départager les deux joueurs :)

Report abuse