Aller au contenu
WoWDBAPI · documentation
Menu

APIPour commencer

Versions du jeu : API de WoWDB

Vanilla, The Burning Crusade, Wrath of the Lich King, Cataclysm et Mists of Pandaria : la version du jeu fait partie de chaque adresse.

Voir en Markdown

Versions du jeu couvertes#

WoWDB couvre cinq versions de World of Warcraft, chacune sur sa version finale, celle des serveurs actuels. La version fait partie du chemin : /v1/{version}/….

CléVersionClientSortieObjetsQuêtesPNJ
classicWorld of Warcraft (Vanilla)1.12.1200415 8464 2439 836
tbcThe Burning Crusade2.4.3200725 7646 36416 768
wotlkWrath of the Lich King3.3.5a200839 1369 07025 062
cataCataclysm4.3.4201052 61613 95338 861
mopMists of Pandaria5.4.8201270 33616 07148 543
GET /v1/versions/{version}
curl https://api.wowdb.assemblee-defias.fr/v1/versions/tbc
Réponse200JSON
{
  "object": "version",
  "id": "tbc",
  "name": "TBC",
  "full_name": "World of Warcraft: The Burning Crusade",
  "patch": "2.4.3",
  "released": 2007,
  "counts": {
    "items": 25764,
    "spells": 10481,
    "quests": 6364,
    "npcs": 16768,
    "game_objects": 1430,
    "item_sets": 339,
    "factions": 58,
    "instances": 51
  },
  "rogue_counts": {
    "items": 6351,
    "quests": 1130,
    "game_objects": 47,
    "item_sets": 62,
    "spells": 446
  },
  "url": "https://wowdb.assemblee-defias.fr/?version=tbc",
  "api_url": "https://api.wowdb.assemblee-defias.fr/v1/versions/tbc"
}

Un identifiant, plusieurs versions#

Un identifiant est le numéro du jeu : la Barbelure cruelle est 5191 en Vanilla, en TBC et en WotLK. Mais la fiche peut changer d’une version à l’autre (statistiques, qualité, butin) : la Lame bourdonnante (2169) est commune en Vanilla et rare en TBC. Demandez toujours la version de votre serveur.

Chaque fiche complète a un champ versions : la même fiche dans chaque version où elle existe, avec son api_url.

AttentionUn numéro qui n’existe pas dans une version répond 404 resource_missing. Une version inconnue (/retail/items) répond 404 version_unknown.
Même objet, deux versionsTerminal
curl https://api.wowdb.assemblee-defias.fr/v1/classic/items/2169   # "quality": "common"
curl https://api.wowdb.assemblee-defias.fr/v1/tbc/items/2169       # "quality": "rare"

Lister les versions du jeu#

GET/v1/versions

Les versions de World of Warcraft couvertes, avec le nombre de fiches de chacune.

Paramètres de requête#

  • 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 version, paginée par curseur.

GET /v1/versions
curl -G https://api.wowdb.assemblee-defias.fr/v1/versions \
  -d limit=1
Réponse200JSON
{
  "object": "list",
  "data": [
    {
      "object": "version",
      "id": "classic",
      "name": "Vanilla",
      "full_name": "World of Warcraft",
      "patch": "1.12.1",
      "released": 2004,
      "counts": {
        "items": 15846,
        "spells": 6963,
        "quests": 4243,
        "npcs": 9836,
        "game_objects": 947,
        "item_sets": 172,
        "factions": 37,
        "instances": 26
      },
      "rogue_counts": {
        "items": 3696,
        "quests": 654,
        "game_objects": 32,
        "item_sets": 41,
        "spells": 297
      },
      "url": "https://wowdb.assemblee-defias.fr/?version=classic",
      "api_url": "https://api.wowdb.assemblee-defias.fr/v1/versions/classic"
    }
  ],
  "has_more": true,
  "next_cursor": "eyJvIjoxLCJoIjoiaHE3T0kwTmVRRiJ9",
  "url": "https://api.wowdb.assemblee-defias.fr/v1/versions"
}

Obtenir une version#

GET/v1/versions/{version}

Une version du jeu et ses effectifs.

Paramètres du chemin#

  • versioncodeobligatoire

    Version du jeu : classic (Vanilla 1.12.1), tbc (2.4.3), wotlk (3.3.5a), cata (4.3.4) ou mop (5.4.8).

    Valeurs : classic, tbc, wotlk, cata, mop

Renvoie#

L’objet version.

GET /v1/versions/{version}
curl https://api.wowdb.assemblee-defias.fr/v1/versions/tbc
Réponse200JSON
{
  "object": "version",
  "id": "tbc",
  "name": "TBC",
  "full_name": "World of Warcraft: The Burning Crusade",
  "patch": "2.4.3",
  "released": 2007,
  "counts": {
    "items": 25764,
    "spells": 10481,
    "quests": 6364,
    "npcs": 16768,
    "game_objects": 1430,
    "item_sets": 339,
    "factions": 58,
    "instances": 51
  },
  "rogue_counts": {
    "items": 6351,
    "quests": 1130,
    "game_objects": 47,
    "item_sets": 62,
    "spells": 446
  },
  "url": "https://wowdb.assemblee-defias.fr/?version=tbc",
  "api_url": "https://api.wowdb.assemblee-defias.fr/v1/versions/tbc"
}

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