Clé d'API de Guild Wars 2

Une API est une interface de programmation applicative (Application Programming Interface, en anglais). Pour faire simple, c’est un moyen d’échanger des données informatiques ou d’envoyer des instructions qui sont normalisées et donc exploitables par un grand nombre de langages différents.

Guild Wars 2 n’est pas le premier à en utiliser : d’autres MMORPG ou grands noms (Facebook, Twitter, LinkedIn) ont une API.

Chaque API est différente, c’est pour cette raison qu’il y a toujours une documentation technique qui les accompagne. Pour Guild Wars 2, elle est disponible en accès libre sur le wiki anglais : https://wiki.guildwars2.com/wiki/API:Main

Si, par exemple, pour Facebook et Twitter, il est possible de leur envoyer des données pour créer du contenu sur votre compte, connaître vos informations personnelles ou vos amis et leur activité, ce n’est absolument pas le cas avec l’API de Guild Wars 2. 

L’API se décompose en deux parties : la première qui est accessible sans identification, c’est-à-dire sans clé, et qui fournit des informations sur le jeu (objets, recettes, succès, mécanismes du jeu, …) ; la seconde est celle qui donne des informations liées à votre compte (si l’autorisation paramétrée le permet).

Dans la grande majorité des cas, utiliser une clé d’API vous facilite la vie. Par exemple, avec GW2Efficiency, qui offre un panel impressionnant d’informations et d’outils pour vous aider en jeu, ou encore GW2Crafts qui permet de savoir quels matériaux vous avez déjà et ceux que vous devez acheter pour monter vos métiers ou encore GW2BLTC si vous avez l’âme d’un trader.

Vous pouvez aussi inventer vos propres utilisations, si explorer les données brutes de l’API ne vous fait pas peur ou en détournant l’utilisation de base d’applications à votre disposition. 
Exemple : j’aide actuellement un joueur à monter son niveau de maîtrises ; pour ne pas l’embêter en lui préparant son programme, je lui ai demandé une clé d’API avec l’autorisation de base “account” ainsi que l'autorisation “progression” ; j’ai ajouté cette clé à GW2Efficiency, sur mon compte (il est possible d’en ajouter plusieurs et de passer d’une clé à l’autre en 2 clics) ; je peux ainsi naviguer de manière libre et autonome dans ses succès pour connaître sa progression et lui proposer des activités utiles lorsque nous jouons ensemble. 

Créer une clé

Rendez-vous sur le site officiel, survolez “Services” et cliquez sur “Mon compte”. Identifiez-vous puis cliquez sur “Applications”. Sur cette page sont listées toutes les clés que vous avez créées. Vous pouvez les supprimer ou modifier leur nom. Pour en créer une nouvelle, cliquez sur "Nouvelle clé". 

Donnez un nom à votre clé pour pouvoir vous rappeler à quoi vous l’avez attribuée quand vous voudrez faire un peu de nettoyage. Personnellement, j’indique l’adresse du site ou le nom de l’application. 

Sélectionnez les autorisations utiles et validez en cliquant sur "Créer une clé d'application". Vous serez automatiquement redirigé sur la liste de vos clés, il ne vous restera plus qu’à trouver celle que vous venez de créer et l’utiliser. 

Focus sur les autorisations

Lorsque vous créez une nouvelle clé API, vous pouvez choisir quel type d’informations vous souhaitez exposer. Si le site ou l'application tente d’accéder à ces informations alors que vous n’avez pas donné l’autorisation nécessaire, il n’aura comme donnée qu’une erreur lui indiquant qu’il n’a pas l’autorisation requise.

• account (cochée par défaut) : les informations de base liées à votre compte, nous le détaillons plus bas ;
• inventories : banque, banque de matériaux, recettes déverrouillées et sacs de vos personnages ;
• characters : informations sur vos personnages (histoire personnelle, nom, race, profession, genre, niveau, âge, nombre de morts, titres, métiers, armes, armure, bijoux, …) ;
• tradingpost : transactions du comptoir en cours et passées ;
• wallet : portefeuille des différentes monnaies du jeu (or, karma, monnaies de donjons, de cartes, …) ;
• unlocks : apparences déverrouillées (miniatures, armures, armes, teintures, …) ;
• pvp : statistiques, historiques, progression, parcours ;
• builds : compétences, aptitudes et spécialisations pour tous les modes de jeu (JcE, JcJ et McM) ;
• progression : succès, donjons, raids, points de maîtrises, … ;
• guilds : liste des membres, historique, MOTD des guildes dont vous êtes membre.

Sachez que vous pouvez à tout moment décider de supprimer une clé, ce qui coupe l’accès à vos données de l’API au tiers avec qui vous l’avez partagée. 

LBM Connect

Nous avons mis en place pour Discord un outil de vérification automatique de compte, pour éviter de se faire embêter par les bots et messages indésirables. Cette fonction permet d’attribuer le rôle “Vérifié”, et “[LBM]” si vous faites partie de la guilde au moment de la vérification. Chacun de ces rôles débloque l’accès à des ensembles de canaux.

Principe de fonctionnement :

• Vous créez ou utilisez une clé existante avec l’autorisation cochée par défaut “account”
• Vous visitez entrez une commande suivie de votre clé API dans l'un de nos canaux sur discord
  • nous pouvons ainsi connaître votre nom de compte GW2 exact et remplacer votre pseudonyme sur le serveur Discord du LBM (vous pouvez utiliser un pseudo Discord différent pour chaque serveur que vous avez rejoint)  par votre nom de compte ;
  • nous vous attachons automatiquement le rôle “Vérifié” ;
  • nous vérifions si, dans la liste de vos guildes, Le Bus Magique (sous l’identifiant “9E833A56-9619-4ABA-837A-6D268D26D6A9”) est bien présent pour vous attribuer le rôle “[LBM]”.

Pour le bon fonctionnement du script, les informations du compte Discord et la clé API sont simplement enregistrées dans une session de votre navigateur, qui est détruite à la fin de l’opération ou si elle a échoué. C’est-à-dire qu’aucune donnée n’est enregistrée en base de données ou dans un fichier, donc inaccessible par les membres de l’équipe du Bus, puisque si nous souhaitons avoir des logs, Discord nous indique très bien les vérifications qui sont faites par ce script. 

Demande de ticket

Un peu avant la sortie de Path of Fire, nous avons mis en place un système d’invitations à rejoindre notre guilde pour automatiser le plus possible les tâches qui y sont liées. En effet, notre cas est un peu particulier car, atteignant régulièrement la limite de 500 membres dans notre guilde, il est parfois difficile de gérer les flux tendus comme à la sortie d’une nouvelle extension ou d’un nouvel épisode.

Du côté des joueurs, il suffit d’indiquer votre clé d’API avec l’autorisation de base “account” et une adresse e-mail valide. La clé nous permet de créer une ligne dans un tableau. L’adresse e-mail est utilisée uniquement pour notifier la personne qui fait la demande, qu’une invitation à rejoindre la guilde lui a été envoyée dans le jeu.

Derrière le guichet, la gestion des tickets

Si nous stockons ces informations en base de données, nous ne conservons pas la clé d’API utilisée, c’est-à-dire que nous conservons des données fournies à un instant T et qu'elles ne sont jamais mises à jour (sans la clé, c'est impossible).

Une fois que l’invitation est clôturée, les informations qui lui sont liées ne sont plus visibles dans notre tableau et sont utilisées à des fins statistiques (les deux graphiques, juste en dessous, qui nous sont utiles pour définir les dates des purges). 

Personnalisation du contenu des guides

Nous essayons de plus en plus de personnaliser votre expérience sur le site, pour en tirer des enseignements avant de le mettre en place sur la prochaine version du site.

Aujourd’hui, pour certains guides, il vous est possible d’indiquer votre clé API pour connaître votre progression dans l’accomplissement du succès ou l’équipement en chats et zones de récolte de votre instance.

Sachez que cette clé est stockée dans votre navigateur, nous ne l’enregistrons jamais en base de données et elle n’est pas rattachée à votre compte sur le site, si vous en avez un.

Vous pouvez la renseigner directement en haut à droite des guides ou dans votre compte du site.