APIPour commencer

API de WoWDB

L’API publique de WoWDB des Défias : 155 848 fiches de World of Warcraft Vanilla, TBC et WotLK, en français, en lecture seule, sans clé.

Voir en Markdown

Introduction#

WoWDB des Défias est la base de données de L’Assemblée des Défias, le repaire des voleurs de World of Warcraft. Son API donne accès aux mêmes fiches que le site : 80 745 objets, 51 791 PNJ, 19 713 quêtes, 2 536 objets du monde, 873 sorts du voleur, 172 réputations, 18 ensembles et 150 donjons et raids, pour les trois versions classiques du jeu.

C’est une API REST qui renvoie du JSON. Elle est publique, gratuite, en lecture seule et sans clé : une adresse suffit, depuis un terminal, un serveur, un bot Discord, un addon, une page web ou un assistant IA.

  • Une adresse de base : https://api.wowdb.assemblee-defias.fr/v1.
  • La version du jeu dans le chemin : /classic/…, /tbc/… ou /wotlk/… (versions du jeu).
  • Des objets typés et stables : chaque réponse a un champ object (item, npc, list…), des noms de champs anglais en snake_case et des codes stables (quality: "epic") ; les textes du jeu restent en français.
  • Des liens partout : chaque objet donne son url (la page WoWDB à montrer à vos lecteurs), son api_url et l’adresse absolue de son icon.
  • Des listes paginées par curseur (pagination), des filtres, dont le filtre voleur, des erreurs JSON homogènes, un cache HTTP avec ETag.
URL de base
https://api.wowdb.assemblee-defias.fr/v1
GET /v1
curl https://api.wowdb.assemblee-defias.fr/v1
Réponse200JSON
{
  "object": "api",
  "name": "API de WoWDB des Défias",
  "version": "v1",
  "released": "2026-10-01",
  "data_updated": "2026-10-01",
  "description": "API publique en lecture seule de WoWDB des Défias : objets, sorts, quêtes, PNJ, objets du monde, ensembles, réputations, donjons et raids de World of Warcraft (Vanilla, TBC, WotLK), en français.",
  "documentation": "https://docs.wowdb.assemblee-defias.fr/",
  "openapi": "https://api.wowdb.assemblee-defias.fr/v1/openapi.json",
  "llms": "https://docs.wowdb.assemblee-defias.fr/llms.txt",
  "website": "https://wowdb.assemblee-defias.fr/",
  "versions": [
    {
      "id": "classic",
      "api_url": "https://api.wowdb.assemblee-defias.fr/v1/versions/classic"
    },
    {
      "id": "tbc",
      "api_url": "https://api.wowdb.assemblee-defias.fr/v1/versions/tbc"
    },
    {
      "id": "wotlk",
      "api_url": "https://api.wowdb.assemblee-defias.fr/v1/versions/wotlk"
    }
  ],
  "endpoints": {
    "search": "https://api.wowdb.assemblee-defias.fr/v1/search?q={texte}",
    "stats": "https://api.wowdb.assemblee-defias.fr/v1/stats",
    "versions": "https://api.wowdb.assemblee-defias.fr/v1/versions",
    "items": "https://api.wowdb.assemblee-defias.fr/v1/{version}/items",
    "spells": "https://api.wowdb.assemblee-defias.fr/v1/{version}/spells",
    "quests": "https://api.wowdb.assemblee-defias.fr/v1/{version}/quests",
    "npcs": "https://api.wowdb.assemblee-defias.fr/v1/{version}/npcs",
    "game_objects": "https://api.wowdb.assemblee-defias.fr/v1/{version}/game-objects",
    "item_sets": "https://api.wowdb.assemblee-defias.fr/v1/{version}/item-sets",
    "factions": "https://api.wowdb.assemblee-defias.fr/v1/{version}/factions",
    "instances": "https://api.wowdb.assemblee-defias.fr/v1/{version}/instances"
  }
}

Démarrage rapide : une première requête en 30 secondes#

  1. Ouvrez un terminal (ou la console de votre navigateur).
  2. Copiez l’exemple ci-contre : la fiche de la Barbelure cruelle, l’épée qu’Edwin VanCleef laisse tomber aux Mortemines.
  3. Lisez la réponse : nom, qualité, niveau, dégâts de l’arme, infobulle du jeu ligne par ligne, et dropped_by : VanCleef, 20 % de chances.

Changez de langage avec le sélecteur en haut de l’exemple : votre choix est retenu sur toutes les pages. Aucune bibliothèque n’est nécessaire : chaque exemple n’utilise que la bibliothèque standard de son langage (sauf Rust). Il existe aussi des bibliothèques clientes d’un seul fichier.

Bon à savoirPas de clé, pas de compte : identifiez simplement votre application dans l’en-tête User-Agent (authentification).
Première requête
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": []
}

Lister, filtrer, paginer#

Les listes acceptent des filtres combinables. Ici, les dagues rares et épiques utiles au voleur jusqu’au niveau 30, de la meilleure à la moins bonne. Le filtre rogue=true est une option : sans lui, la liste contient tout.

Une liste renvoie { object: "list", data, has_more, next_cursor, url } : pour la page suivante, repassez next_cursor dans cursor (pagination).

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"
}

Ressources#

Ce que vous pouvez construire#

  • Un bot Discord qui répond !objet Barbelure cruelle avec l’icône, l’infobulle et le lien WoWDB.
  • Le site de votre guilde : butin des raids, listes de souhaits, réputations à monter.
  • Un outil de comparaison de dagues ou d’épées par dégâts par seconde (weapon.dps).
  • Une carte des coffres à crocheter d’une zone, avec /game-objects/{id}/locations.
  • Un assistant IA qui cite des fiches exactes au lieu d’inventer : llms.txt et Markdown.

Pour les assistants IA#

Chaque page de cette documentation existe en Markdown (lien « Voir en Markdown », ou ajoutez .md à l’adresse) et se copie d’un clic avec « Copier pour un LLM ». L’index llms.txt liste toutes les pages, et llms-full.txt les réunit en un seul fichier. La spécification complète est en OpenAPI 3.1.

API de WoWDB des Défias, v1. Données du jeu © Blizzard Entertainment. Conditions d’usage · Markdown · llms.txt · OpenAPI