APIRéférence

Ensembles

Les ensembles d’armure : pièces et bonus.

Les ensembles d’armure cités par les guides (en TBC), avec leurs pièces et leurs bonus dans l’infobulle. Exemple : l’Armure Sombreruse (184), l’ensemble de donjon du voleur.

Routes

GET/v1/{version}/item-sets
GET/v1/{version}/item-sets/{id}

L’objet item_set#

Un ensemble.

Champs#

objectchaîne
Type d’objet, toujours « item_set ».
Valeurs : item_set
identier
Identifiant de l’ensemble : son numéro dans le jeu (entrée de la base du jeu), le même dans les trois versions quand l’ensemble y existe.
keychaîne
Clé WoWDB, unique dans toute la base : « <version>:<type>:<id> » (tbc:item-set:184).
versioncode
Version du jeu de cette fiche.
Valeurs : classic, tbc, wotlk
namechaîne
Nom français, comme en jeu.
iconchaîne ou null
Adresse absolue de l’icône du jeu (WebP, JPEG ou PNG), servie par WoWDB ; null si la fiche n’en a pas.
tooltiptableau de chaînes
Infobulle de l’ensemble : pièces et bonus, ligne par ligne.
urlchaîne
Adresse publique de la fiche sur WoWDB (page HTML, à donner à vos lecteurs).
api_urlchaîne
Adresse de l’ensemble dans l’API.

Fiche seulement (GET …/{id})#

versionstableau de Ref
La même fiche dans chaque version du jeu où elle existe (elle comprise).
guidestableau d’objets
Guides de L’Assemblée des Défias qui citent cette fiche.
2 attributs enfants
- titlechaîne
  Titre du guide.
- urlchaîne
  Adresse du guide sur assemblee-defias.fr.

Exemple : ensemble200JSON

{
  "object": "item_set",
  "id": 184,
  "key": "tbc:item-set:184",
  "version": "tbc",
  "name": "Armure Sombreruse",
  "icon": "https://wowdb.assemblee-defias.fr/database-icons/inv_chest_leather_07.jpg",
  "tooltip": [
    "Armure Sombreruse",
    "Cuir",
    "Ensemble de donjon 1 (Classic)",
    "2 pièces:",
    "+200 à l'Armure.",
    "4 pièces:",
    "Augmente de 40 la puissance d'attaque.",
    "6 pièces:",
    "Confère une chance lors d'attaques de mêlée de recevoir 35 points d'énergie.",
    "8 pièces:",
    "+8 à toutes les résistances."
  ],
  "url": "https://wowdb.assemblee-defias.fr/?id=tbc:item-set:184",
  "api_url": "https://api.wowdb.assemblee-defias.fr/v1/tbc/item-sets/184",
  "versions": [
    {
      "object": "item_set",
      "id": 184,
      "version": "tbc",
      "name": "Armure Sombreruse",
      "url": "https://wowdb.assemblee-defias.fr/?id=tbc:item-set:184",
      "api_url": "https://api.wowdb.assemblee-defias.fr/v1/tbc/item-sets/184"
    }
  ],
  "guides": [
    {
      "title": "Choisir sa race (Alliance)",
      "url": "https://assemblee-defias.fr/racesalliance.html"
    },
    {
      "title": "Choisir sa race (Horde)",
      "url": "https://assemblee-defias.fr/raceshorde.html"
    },
    {
      "title": "Pic de Rochenoire Inférieur (LBRS)",
      "url": "https://assemblee-defias.fr/lbrs.html"
    },
    {
      "title": "Pic de Rochenoire Supérieur (UBRS)",
      "url": "https://assemblee-defias.fr/ubrs.html"
    },
    {
      "title": "Scholomance",
      "url": "https://assemblee-defias.fr/scholo.html"
    },
    {
      "title": "Sets d'armure",
      "url": "https://assemblee-defias.fr/stats.html"
    },
    {
      "title": "Stratholme",
      "url": "https://assemblee-defias.fr/strat.html"
    }
  ]
}

Lister les ensembles#

GET/v1/{version}/item-sets

Les ensembles d’armure cités par les guides (TBC).

Paramètres du chemin#

versioncodeobligatoire
Version du jeu : classic (Vanilla 1.12.1), tbc (2.4.3) ou wotlk (3.3.5a).
Valeurs : classic, tbc, wotlk

Paramètres de requête#

qchaîne
Filtre sur le nom : chaque mot doit commencer un mot du nom (« lame om » trouve « Lame de l’ombre »). Sans accent ni majuscule nécessaires.
sortchaîne
Ordre : name ; « - » devant inverse l’ordre (-item_level : du plus haut au plus bas). Valeurs vides en fin de liste. Par défaut : name.
Valeurs : name, -name
limitentier
Nombre d’éléments par page, de 1 à 100 (20 par défaut).
cursorchaîne
Curseur de la page suivante : la valeur de next_cursor de la page précédente, avec les mêmes filtres.
include_totalbooléen
true : ajoute total_count, le nombre total d’éléments avec ces filtres.

Renvoie#

Une liste (object: "list") d’objets item_set, paginée par curseur.

GET /v1/{version}/item-sets

curl -G https://api.wowdb.assemblee-defias.fr/v1/tbc/item-sets \
  -d limit=2

Réponse200JSON

{
  "object": "list",
  "data": [
    {
      "object": "item_set",
      "id": 213,
      "key": "tbc:item-set:213",
      "version": "tbc",
      "name": "Armure Croc-de-sang",
      "icon": "https://wowdb.assemblee-defias.fr/database-icons/inv_chest_cloth_07.jpg",
      "tooltip": [
        "Armure Croc-de-sang",
        "Classe:",
        "Voleur",
        "Set de Raid Palier 2 (Classic)",
        "3 pièces:",
        "Augmente vos chances d'appliquer des poisons sur votre cible de 5%.",
        "5 pièces:",
        "Améliore la réduction de niveau de menace de la Feinte de 25%.",
        "8 pièces:",
        "Donne au voleur une chance d'infliger 283 à 317 points de dégâts à la cible et de le guérir de 50 points de vie toutes les 1 sec. pendant 6 s lorsqu'il touche un adversaire en mêlée."
      ],
      "url": "https://wowdb.assemblee-defias.fr/?id=tbc:item-set:213",
      "api_url": "https://api.wowdb.assemblee-defias.fr/v1/tbc/item-sets/213"
    },
    {
      "object": "item_set",
      "id": 143,
      "key": "tbc:item-set:143",
      "version": "tbc",
      "name": "Armure de diablosaure",
      "icon": "https://wowdb.assemblee-defias.fr/database-icons/inv_pants_wolf.jpg",
      "tooltip": [
        "Armure de diablosaure",
        "Cuir",
        "2 pièces:",
        "Augmente votre score de toucher de 20."
      ],
      "url": "https://wowdb.assemblee-defias.fr/?id=tbc:item-set:143",
      "api_url": "https://api.wowdb.assemblee-defias.fr/v1/tbc/item-sets/143"
    }
  ],
  "has_more": true,
  "next_cursor": "eyJrIjpbImFybXVyZSBkZSBkaWFibG9zYXVyZSIsInRiYzppdGVtLXNldDoxNDMiXSwiaCI6Im1vcHhYalVBM3gifQ",
  "url": "https://api.wowdb.assemblee-defias.fr/v1/tbc/item-sets"
}

Obtenir un ensemble#

GET/v1/{version}/item-sets/{id}

La fiche complète de l’ensemble : les champs de la liste, plus ceux marqués « fiche seulement ».

Paramètres du chemin#

versioncodeobligatoire
Version du jeu : classic (Vanilla 1.12.1), tbc (2.4.3) ou wotlk (3.3.5a).
Valeurs : classic, tbc, wotlk
identierobligatoire
Identifiant du jeu de l’ensemble.

Renvoie#

La fiche complète, objet item_set (champs du résumé et champs « fiche seulement »), ou une erreur 404.

GET /v1/{version}/item-sets/{id}

curl https://api.wowdb.assemblee-defias.fr/v1/tbc/item-sets/184

Réponse200JSON

{
  "object": "item_set",
  "id": 184,
  "key": "tbc:item-set:184",
  "version": "tbc",
  "name": "Armure Sombreruse",
  "icon": "https://wowdb.assemblee-defias.fr/database-icons/inv_chest_leather_07.jpg",
  "tooltip": [
    "Armure Sombreruse",
    "Cuir",
    "Ensemble de donjon 1 (Classic)",
    "2 pièces:",
    "+200 à l'Armure.",
    "4 pièces:",
    "Augmente de 40 la puissance d'attaque.",
    "6 pièces:",
    "Confère une chance lors d'attaques de mêlée de recevoir 35 points d'énergie.",
    "8 pièces:",
    "+8 à toutes les résistances."
  ],
  "url": "https://wowdb.assemblee-defias.fr/?id=tbc:item-set:184",
  "api_url": "https://api.wowdb.assemblee-defias.fr/v1/tbc/item-sets/184",
  "versions": [
    {
      "object": "item_set",
      "id": 184,
      "version": "tbc",
      "name": "Armure Sombreruse",
      "url": "https://wowdb.assemblee-defias.fr/?id=tbc:item-set:184",
      "api_url": "https://api.wowdb.assemblee-defias.fr/v1/tbc/item-sets/184"
    }
  ],
  "guides": [
    {
      "title": "Choisir sa race (Alliance)",
      "url": "https://assemblee-defias.fr/racesalliance.html"
    },
    {
      "title": "Choisir sa race (Horde)",
      "url": "https://assemblee-defias.fr/raceshorde.html"
    },
    {
      "title": "Pic de Rochenoire Inférieur (LBRS)",
      "url": "https://assemblee-defias.fr/lbrs.html"
    },
    {
      "title": "Pic de Rochenoire Supérieur (UBRS)",
      "url": "https://assemblee-defias.fr/ubrs.html"
    },
    {
      "title": "Scholomance",
      "url": "https://assemblee-defias.fr/scholo.html"
    },
    {
      "title": "Sets d'armure",
      "url": "https://assemblee-defias.fr/stats.html"
    },
    {
      "title": "Stratholme",
      "url": "https://assemblee-defias.fr/strat.html"
    }
  ]
}