APIRéférence

Objets

Les 80 745 objets de Vanilla, TBC et WotLK : qualité, niveaux, emplacement, dégâts, prix, infobulle, sources, filtre voleur.

Voir en Markdown

Tout le catalogue des objets du jeu, dans les trois versions : armes, armures, consommables, recettes, objets de quête… Les objets internes du jeu (tests, doublons, objets jamais sortis) sont absents des listes et de la recherche, mais restent joignables par leur numéro, avec internal: true.

Routes

GET/v1/{version}/items
GET/v1/{version}/items/{id}

L’objet item#

Un objet du jeu. Les listes renvoient le résumé ; la fiche ajoute les champs « fiche seulement » : sources de butin, quêtes, réputation requise, versions, guides.

Champs#

objectchaîne
Type d’objet, toujours « item ».
Valeurs : item
identier
Identifiant de l’objet : son numéro dans le jeu (entrée de la base du jeu), le même dans les trois versions quand l’objet y existe.
keychaîne
Clé WoWDB, unique dans toute la base : « <version>:<type>:<id> » (classic:item:5191).
versioncode
Version du jeu de cette fiche.
Valeurs : classic, tbc, wotlk
namechaîne
Nom français, comme en jeu.
qualitycode ou null
Qualité de l’objet (couleur du nom en jeu).
Valeurs : poor, common, uncommon, rare, epic, legendary, artifact, heirloom
quality_namechaîne ou null
Qualité, libellé français.
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.
item_levelentier ou null
Niveau d’objet.
required_levelentier ou null
Niveau requis pour l’équiper ou l’utiliser.
slotcode ou null
Emplacement d’équipement ; null si l’objet ne se porte pas.
Valeurs : voir les codes.
slot_namechaîne ou null
Emplacement, libellé du jeu (« À une main »).
typecode ou null
Type d’objet : sous-classe pour les armes et armures (dague, cuir…), classe pour les autres.
Valeurs : voir les codes.
type_namechaîne ou null
Type, libellé français.
weaponobjet ou null
Caractéristiques d’arme lues dans l’infobulle ; null hors des armes.
4 attributs enfants
- damage_minentier
  Dégâts minimum.
- damage_maxentier
  Dégâts maximum.
- speednombre
  Vitesse d’attaque en secondes.
- dpsnombre
  Dégâts par seconde.
sell_priceentier ou null
Prix de vente à un marchand, en pièces de cuivre (10 000 = 1 pièce d’or) ; null si invendable.
roguebooléen
Utile au voleur : arme ou armure qu’il porte, objet qui lui est réservé, fourniture (poisons, crochets, poudres), objet cité par un guide.
internalbooléen
Objet interne du jeu (test, doublon, jamais sorti) : absent des listes et de la recherche, mais joignable par son identifiant.
tooltiptableau de chaînes
Infobulle du jeu, ligne par ligne, en français (sans le prix de vente, donné par sell_price).
urlchaîne
Adresse publique de la fiche sur WoWDB (page HTML, à donner à vos lecteurs).
api_urlchaîne
Adresse de l’objet dans l’API.

Fiche seulement (GET …/{id})#

required_reputationobjet ou null
Réputation requise pour l’acheter ou l’utiliser.
4 attributs enfants
- factionRef ou null
  La réputation, quand elle a une fiche.
- namechaîne
  Nom de la faction.
- rankcode ou null
  Rang requis.
  Valeurs : hated, hostile, unfriendly, neutral, friendly, honored, revered, exalted
- rank_namechaîne ou null
  Rang requis, libellé du jeu.
dropped_bytableau d’objets
Où il tombe dans les donjons et raids : monstres, boss et coffres, par difficulté.
8 attributs enfants
- source_typechaîne
  « npc » (créature) ou « game_object » (coffre).
- namechaîne
  Nom de la source.
- npcRef ou null
  Fiche du PNJ, quand elle existe.
- bossbooléen
  Vrai pour un boss.
- instanceInstanceRef
  Le donjon ou raid.
- difficultycode ou null
  Difficulté.
  Valeurs : normal, heroic, 10_player, 25_player, 10_player_heroic, 25_player_heroic
- difficulty_namechaîne ou null
  Difficulté, libellé français.
- chancenombre ou null
  Chance de butin en pour cent.
rewarded_bytableau d’objets
Quêtes qui le donnent en récompense.
2 attributs enfants
- questRef
  La quête.
- choicebooléen
  Vrai si c’est une récompense au choix.
summonsobjet ou null
Monture ou compagnon que l’objet invoque.
3 attributs enfants
- typechaîne
  « mount », « companion » ou « other ».
- namechaîne ou null
  Nom de la créature.
- npcRef ou null
  Fiche de la créature.
other_namestableau de chaînes
Autres noms : nom anglais, anciens noms français.
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 : objet200JSON

{
  "object": "item",
  "id": 5191,
  "key": "classic:item:5191",
  "version": "classic",
  "name": "Barbelure cruelle",
  "quality": "rare",
  "quality_name": "Rare",
  "icon": "https://wowdb.assemblee-defias.fr/database-icons/inv_sword_24.jpg",
  "item_level": 24,
  "required_level": 19,
  "slot": "one_hand",
  "slot_name": "À une main",
  "type": "sword",
  "type_name": "Épée",
  "weapon": {
    "damage_min": 30,
    "damage_max": 57,
    "speed": 2.8,
    "dps": 15.5
  },
  "sell_price": 2964,
  "rogue": true,
  "internal": false,
  "tooltip": [
    "Barbelure cruelle",
    "Niveau d'objet 24",
    "Lié quand ramassé",
    "À une main",
    "Épée",
    "Dégâts : 30 - 57",
    "Vitesse 2.80",
    "(15.5 dégâts par seconde)",
    "Durabilité 75 / 75",
    "Niveau 19 requis",
    "Équipé : Augmente de 12 la puissance d'attaque."
  ],
  "url": "https://wowdb.assemblee-defias.fr/?id=classic:item:5191",
  "api_url": "https://api.wowdb.assemblee-defias.fr/v1/classic/items/5191",
  "required_reputation": null,
  "dropped_by": [
    {
      "source_type": "npc",
      "name": "Edwin VanCleef",
      "npc": {
        "object": "npc",
        "id": 639,
        "version": "classic",
        "name": "Edwin VanCleef",
        "url": "https://wowdb.assemblee-defias.fr/?id=classic:npc:639",
        "api_url": "https://api.wowdb.assemblee-defias.fr/v1/classic/npcs/639"
      },
      "boss": true,
      "instance": {
        "object": "instance",
        "id": 36,
        "version": "classic",
        "name": "Mortemines",
        "type": "dungeon",
        "url": "https://wowdb.assemblee-defias.fr/?instance=classic:36",
        "api_url": "https://api.wowdb.assemblee-defias.fr/v1/classic/instances/36"
      },
      "difficulty": "normal",
      "difficulty_name": "Normal",
      "chance": 20
    }
  ],
  "rewarded_by": [],
  "summons": null,
  "other_names": [],
  "versions": [
    {
      "object": "item",
      "id": 5191,
      "version": "classic",
      "name": "Barbelure cruelle",
      "url": "https://wowdb.assemblee-defias.fr/?id=classic:item:5191",
      "api_url": "https://api.wowdb.assemblee-defias.fr/v1/classic/items/5191"
    },
    {
      "object": "item",
      "id": 5191,
      "version": "tbc",
      "name": "Barbelure cruelle",
      "url": "https://wowdb.assemblee-defias.fr/?id=tbc:item:5191",
      "api_url": "https://api.wowdb.assemblee-defias.fr/v1/tbc/items/5191"
    },
    {
      "object": "item",
      "id": 5191,
      "version": "wotlk",
      "name": "Barbelure cruelle",
      "url": "https://wowdb.assemblee-defias.fr/?id=wotlk:item:5191",
      "api_url": "https://api.wowdb.assemblee-defias.fr/v1/wotlk/items/5191"
    }
  ],
  "guides": []
}

Lister les objets#

GET/v1/{version}/items

Tous les objets d’une version (internes exclus), triés par nom par défaut. Le filtre rogue=true garde ceux qui servent au voleur.

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.
qualitycodes séparés par des virgules
Qualités. Plusieurs valeurs séparées par des virgules.
Valeurs : poor, common, uncommon, rare, epic, legendary, artifact, heirloom
slotcodes séparés par des virgules
Emplacements. Plusieurs valeurs séparées par des virgules.
Valeurs : voir les codes.
typecodes séparés par des virgules
Types d’objet. Plusieurs valeurs séparées par des virgules.
Valeurs : voir les codes.
min_levelentier
Niveau requis minimum (1 à 100).
max_levelentier
Niveau requis maximum (1 à 100).
min_item_levelentier
Niveau d’objet minimum.
max_item_levelentier
Niveau d’objet maximum.
roguebooléen
true : seulement les objets utiles au voleur ; false : seulement les autres. Absent : tout (par défaut).
sortchaîne
Ordre : name, item_level, required_level, quality ; « - » 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, item_level, -item_level, required_level, -required_level, quality, -quality
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, paginée par curseur.

GET /v1/{version}/items

curl -G https://api.wowdb.assemblee-defias.fr/v1/classic/items \
  -d type=dagger \
  -d rogue=true \
  -d quality=rare,epic \
  -d max_level=30 \
  -d sort=-item_level \
  -d limit=2

Réponse200JSON

{
  "object": "list",
  "data": [
    {
      "object": "item",
      "id": 23168,
      "key": "classic:item:23168",
      "version": "classic",
      "name": "Dague focale de Dédain",
      "quality": "rare",
      "quality_name": "Rare",
      "icon": "https://wowdb.assemblee-defias.fr/database-icons/inv_weapon_shortblade_07.jpg",
      "item_level": 35,
      "required_level": 30,
      "slot": "one_hand",
      "slot_name": "À une main",
      "type": "dagger",
      "type_name": "Dague",
      "weapon": {
        "damage_min": 22,
        "damage_max": 42,
        "speed": 1.4,
        "dps": 22.9
      },
      "sell_price": 2665,
      "rogue": true,
      "internal": false,
      "tooltip": [
        "Dague focale de Dédain",
        "Niveau d'objet 35",
        "Lié quand ramassé",
        "À une main",
        "Dague",
        "Dégâts : 22 - 42",
        "Vitesse 1.40",
        "(22.9 dégâts par seconde)",
        "Durabilité 65 / 65",
        "Niveau 30 requis",
        "Équipé : Augmente les dégâts et les soins produits par les sorts et effets magiques de 9 au maximum."
      ],
      "url": "https://wowdb.assemblee-defias.fr/?id=classic:item:23168",
      "api_url": "https://api.wowdb.assemblee-defias.fr/v1/classic/items/23168"
    },
    {
      "object": "item",
      "id": 6691,
      "key": "classic:item:6691",
      "version": "classic",
      "name": "Surin de brochepourceau",
      "quality": "rare",
      "quality_name": "Rare",
      "icon": "https://wowdb.assemblee-defias.fr/database-icons/inv_misc_bone_06.jpg",
      "item_level": 35,
      "required_level": 30,
      "slot": "one_hand",
      "slot_name": "À une main",
      "type": "dagger",
      "type_name": "Dague",
      "weapon": {
        "damage_min": 24,
        "damage_max": 45,
        "speed": 1.5,
        "dps": 23
      },
      "sell_price": 8866,
      "rogue": true,
      "internal": false,
      "tooltip": [
        "Surin de brochepourceau",
        "Niveau d'objet 35",
        "Lié quand ramassé",
        "Unique",
        "À une main",
        "Dague",
        "Dégâts : 24 - 45",
        "Vitesse 1.50",
        "(23.0 dégâts par seconde)",
        "+6 Endurance",
        "+4 Esprit",
        "Durabilité 65 / 65",
        "Niveau 30 requis"
      ],
      "url": "https://wowdb.assemblee-defias.fr/?id=classic:item:6691",
      "api_url": "https://api.wowdb.assemblee-defias.fr/v1/classic/items/6691"
    }
  ],
  "has_more": true,
  "next_cursor": "eyJrIjpbLTM1LCJzdXJpbiBkZSBicm9jaGVwb3VyY2VhdSIsImNsYXNzaWM6aXRlbTo2NjkxIl0sImgiOiJqY1BDbFRNSFQyIn0",
  "url": "https://api.wowdb.assemblee-defias.fr/v1/classic/items?max_level=30&quality=rare%2Cepic&rogue=true&sort=-item_level&type=dagger"
}

Obtenir un objet#

GET/v1/{version}/items/{id}

La fiche complète de l’objet : 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’objet.

Renvoie#

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

GET /v1/{version}/items/{id}

curl https://api.wowdb.assemblee-defias.fr/v1/classic/items/5191

Réponse200JSON

{
  "object": "item",
  "id": 5191,
  "key": "classic:item:5191",
  "version": "classic",
  "name": "Barbelure cruelle",
  "quality": "rare",
  "quality_name": "Rare",
  "icon": "https://wowdb.assemblee-defias.fr/database-icons/inv_sword_24.jpg",
  "item_level": 24,
  "required_level": 19,
  "slot": "one_hand",
  "slot_name": "À une main",
  "type": "sword",
  "type_name": "Épée",
  "weapon": {
    "damage_min": 30,
    "damage_max": 57,
    "speed": 2.8,
    "dps": 15.5
  },
  "sell_price": 2964,
  "rogue": true,
  "internal": false,
  "tooltip": [
    "Barbelure cruelle",
    "Niveau d'objet 24",
    "Lié quand ramassé",
    "À une main",
    "Épée",
    "Dégâts : 30 - 57",
    "Vitesse 2.80",
    "(15.5 dégâts par seconde)",
    "Durabilité 75 / 75",
    "Niveau 19 requis",
    "Équipé : Augmente de 12 la puissance d'attaque."
  ],
  "url": "https://wowdb.assemblee-defias.fr/?id=classic:item:5191",
  "api_url": "https://api.wowdb.assemblee-defias.fr/v1/classic/items/5191",
  "required_reputation": null,
  "dropped_by": [
    {
      "source_type": "npc",
      "name": "Edwin VanCleef",
      "npc": {
        "object": "npc",
        "id": 639,
        "version": "classic",
        "name": "Edwin VanCleef",
        "url": "https://wowdb.assemblee-defias.fr/?id=classic:npc:639",
        "api_url": "https://api.wowdb.assemblee-defias.fr/v1/classic/npcs/639"
      },
      "boss": true,
      "instance": {
        "object": "instance",
        "id": 36,
        "version": "classic",
        "name": "Mortemines",
        "type": "dungeon",
        "url": "https://wowdb.assemblee-defias.fr/?instance=classic:36",
        "api_url": "https://api.wowdb.assemblee-defias.fr/v1/classic/instances/36"
      },
      "difficulty": "normal",
      "difficulty_name": "Normal",
      "chance": 20
    }
  ],
  "rewarded_by": [],
  "summons": null,
  "other_names": [],
  "versions": [
    {
      "object": "item",
      "id": 5191,
      "version": "classic",
      "name": "Barbelure cruelle",
      "url": "https://wowdb.assemblee-defias.fr/?id=classic:item:5191",
      "api_url": "https://api.wowdb.assemblee-defias.fr/v1/classic/items/5191"
    },
    {
      "object": "item",
      "id": 5191,
      "version": "tbc",
      "name": "Barbelure cruelle",
      "url": "https://wowdb.assemblee-defias.fr/?id=tbc:item:5191",
      "api_url": "https://api.wowdb.assemblee-defias.fr/v1/tbc/items/5191"
    },
    {
      "object": "item",
      "id": 5191,
      "version": "wotlk",
      "name": "Barbelure cruelle",
      "url": "https://wowdb.assemblee-defias.fr/?id=wotlk:item:5191",
      "api_url": "https://api.wowdb.assemblee-defias.fr/v1/wotlk/items/5191"
    }
  ],
  "guides": []
}