@ix-xs/metamob.api

@ix-xs/metamob.api

Metamob

Connectez-vous ou Inscrivez-vous pour profiter des avantages du site :

• Suivez votre avancement dans la quête
• Gérez finement vos monstres
• Visualisez votre profil
• Echangez avec d'autres joueurs
• Une question ? Regardez l'aide

🌐API

Une clé API sert à interroger les données de Metamob pour pouvoir les utiliser ailleurs: dans une feuille Google Sheets, sur une application web, dans un bot Discord...

Vous trouverez plus d'informations dans la page d'aide.

Utiliser une clé API requiert des connaissances en développement. Si vous ne savez pas ce qu'est une API ni comment l'utiliser, ce n'est pas la peine de créer une clé.
Les clés API sont automatiquement supprimées au bout de 90 jours sans utilisation.

🗝️Récupérer une clé

Pour créer votre clé, rendez-vous dans votre espace et cliquez sur l'onglet "API". Vous devrez saisir un nom. Gardez à l'esprit que vous ne pouvez créer qu'une seule clé API pour l'instant.
Votre clé sera immédiatement utilisable.

✨Installation

npm install @ix-xs/metamob.api

👀Utilisation

1. Créez un nouveau client en fournissant votre clé API Metamob :

const MetamobAPI = require("@ix-xs/metamob.api");

const client = new MetamobAPI({ apiKey:"votre_clé_api" });

2. Liste des appels possibles

Méthode	options	Description
getUser()	username:string;	Récupère les informations d'un utilisateur. Non sensible à la casse.
getUserMonsters()	username:string; { type?:string; monstre?:string; etape?:string; quantite?:string; etat?:string; }	Récupère les monstres d'un utilisateur. Le nom d'utilisateur n'est pas sensible à la casse.
getMonsters()	{ monstre?:string; etape?:string; type?:string; }	Récupère les monstres.
getServers()	server?:string;	Récupère les serveurs.
getKralamoures()	{ serveur?:string; date_debut?:string; date_fin?:string; }	Récupère les kralamoures.
getZones()	zone?:string;	Récupère les zones.
getSouszones()	souszone?:string;	Récupère les sous-zones.
putUserMonsters()	username:string uniqueId:string body:Array<{ monstre:string; quantite?:string; etat?:string; }>	Met à jour les informations de monstre d'un compte utilisateur. Le champ quantite indique l'opération à effectuer sur la quantité: • Si la quantité renseigner commence par "===", la quantité du monstre sera forcée à cette valeur. • Si la quantité renseigner commence par "+", la quantité du monstre sera incrémenter de cette valeur • Si la quantité renseigner commence par "-", la quantité du monstre sera décrémenter de cette valeur
resetUserMonsters()	username:string; uniqueId:string;	Réinitialise les monstres sur le compte. Cela signifie que toutes les informations relatives aux monstres seront supprimées ! Les monstres seront mis à l'état aucun (ni recherché ni proposé), avec une quantité nulle (0).

3. Exemples

const MetamobAPI = require("@ix-xs/metamob.api");

const client = new MetamobAPI({ apiKey:"votre_clé_api" });

// Renvoie les informations de l'utilisateur
client.getUser("popop").then(console.log);

// Renvoie les monstres "proposés" dont l'utilisateur possède en + de 1 exemplaire
client.getUserMonsters("popop", { etat:"propose", quantite:">1" }).then(console.log);
 // Renvoie les monstres de l'utilisateur à l'étape 20
client.getUserMonsters("popop", { etape:"20" }).then(console.log);

// Renvoie la liste de tous les monstres
client.getMonsters().then(console.log);
// Renvoie la liste de tous les archimonstres
client.getMonsters({ type:"archimonstre" }).then(console.log);

// Renvoie la liste de tous les serveurs
client.getServers().then(console.log);
// Renvoie les informations sur le serveur "Tylezia"
client.getServers("Tylezia").then(console.log);

// Renvoie la liste des ouvertures prévues entre la date du jour et 1 mois plus tard
client.getKralamoures().then(console.log);
 // Renvoie la liste des ouvertures prévues entre la date du jour et le 01 juin 2024 sur le serveur Tylezia
client.getKralamoures({ serveur:"Tylezia", date_fin:"2023-06-01" }).then(console.log);

// Renvoie la liste de toutes les zones
client.getZones().then(console.log); 
// Renvoie les informations sur la zone Amakna
client.getZones("Amakna").then(console.log);

// Renvoie la liste de toutes les sous-zones.
client.getSouszones().then(console.log);
// Renvoie les informations sur la sous-zones Aerdala
client.getSouszones("Aerdala").then(console.log);

// La quantité du monstre Arakne sera incrémenter de 5 et passera à l'état proposé
// La quantité du monstre Larchimaide la Poussée passera à 3
// La quantité du monstre Bouftou Royal sera décrémenter de 2
client.putUserMonsters("nom_utilisateur", "id_unique_utilisateur", [
	{ monstre:"Arakne", quantite:"+5", etat:"propose" },
	{ monstre:"Larchimaide la Poussée", quantite:"===3" },
	{ monstre:"Bouftou Royal", quantite:"-2" },
]).then(console.log);

// Tous les monstres de l'utilisateur seront réinitialiser (quantite à 0 et aucun état)
client.resestUserMonsters("pseudo_utilisateur", "id_unique_utilisateur").then(console.log);

Contactez moi sur Discord si vous rencontrez des difficultés : ix_xs