Palamazon-api NPM

Palamazon-api

Ce package est relié au Palamazon et vous permet d'avoir diverses informations du Palamazon, que nous verrons dans la section utilisation.

Installation

Utilisez npm pour installer ce package.

npm i --s palamazon-api

Utilisation

Les erreurs

On commence avec du bon, mais cette partie est courte. Les erreurs se présentent sous cette forme :

{error:{"message": "Message d'erreur"}}

C'est tout pour cette partie. Ouaip, c'était vraiment court.

Avoir les informations d'une commande

// Ici, on va récuperer les informations de la commande BF3CAC.
let cmd = "BF3CAC", // Non obligatoire, on définit la commande dont on veut récupérer les informations.
api = require('palamazon-api'),
client = new api.Client();

client.getCmdInfo(cmd).then(info => {
console.log(info)
})

/*
Ce code renvoie du soit une erreur, soit les informations de la commande, ici définies sous la variable info.
*/

Si il n'y a pas d'erreur, les informations de la commande devraient se présenter comme ceci :

{
  authorId: 'Id du client',
  orderedItem: 'Item commandé',
  quantity: 'Quantité',
  price: 'Prix total',
  unity: 'Prix unité',
  id: 'Identifiant de la commande',
  status: 'Statut de la commande',
  seller: 'Vendeur ayant reservé la commande'
}

La variable seller n'est là uniquement si un vendeur a déjà réservé la commande.

Avoir la dernière commande d'un utilisateur

Ce code servira à avoir la dernière commande enregistrée pour l'utilisateur demandé. Si la dernière commande passée a été supprimée ou est déjà livrée, le résultat affiché sera null.

let user = /* c'est optionnel ! */ "650856286983946241",
api = require('palamazon-api'),
client = new api.Client();

client.getLastOrder(user).then(order => {
  console.log(order)
})

Tout simple !

Avoir le prix d'un item

Ce code vous permettra d'avoir le prix d'un item précis. La liste des items valables est notée ici.

let api = require('palamazon-api'), Client = new api.Client();

Client.getItemPrice("lingot(s) de Paladium").then(ans => {
  console.log(ans) // Devrait envoyer le prix/unité, ici 781.25 
})

Notez que les majuscules ne sont pas obligatoires !

Avoir la liste des commandes reservées par un vendeur

// On va chercher à avoir les commandes reservées par l'utilisateur "304541381798658048".
const
  seller = "304541381798658048", // Optionnel !
  api = require('palamazon-api'),
  client = new api.Client();

  client.getSellerCommands(seller).then(cmds => {
    console.log(cmds)
  })
  /*
  Ce code vous renvoie les informations sous forme d'array (exemple : ["1", "2", "3"] etc). Vous pouvez les séparer par un retour à la ligne en utilisant cmds.join("\n").
  */

Avoir le timeout d'un utilisateur

// On va chercher à avoir le timeout de l'utilisateur "304541381798658048".
const
  user = "304541381798658048", // Toujours optionnel
  api = require('palamazon-api'),
  client = new api.Client();

client.getTimeout(user).then(time => {
  console.log(time)
})
/* Ce code peut vous renvoyer soit :
  - Une erreur
  - {"CanOrder": true} (l'utilisateur peut commander)
  - {CanOrder: false, time:{hours: "heures", minutes: "minutes", seconds: "secondes"}} (l'utilisateur ne peut pas commander.)
*/

Avoir la liste des commandes

// De loin le code le moins long de l'api.
const
  api = require('palamazon-api'),
  client = new api.Client();

client.getCmdList().then(cmds => {
  console.log(cmds)
}) // Plutôt simple, aucune erreur ne peut être renvoyée. Elle est pas belle la vie ?

Vérifier si un utilisateur est dans la blacklist

const
  user = "304541381798658048", // T o u j o u r s   o p t i o n n e l
  api = require('palamazon-api'),
  client = new api.Client();

client.verifyBl(user).then(answer => {
  console.log(answer) // True si il est dans la blacklist, false si il n'y est pas.
})

Et enfin, avoir les informations d'un vendeur

// On va prendre celui qui a le plus de ventes, à savoir 320331197836427276 (Superbalou)
const
  user = "320331197836427276", // Vous connaissez la chanson.
  api = require('palamazon-api'),
  client = new api.Client()

client.getSellerInfos(user).then(inf => {
  console.log(inf) // Soit les infos, soit une erreur !
})