APIPour commencer

Versions du jeu

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

Trois versions du jeu#

WoWDB couvre les trois versions classiques de World of Warcraft, sur leur version finale, celle des serveurs actuels. La version fait partie du chemin : /v1/{version}/….

Clé	Version	Client	Sortie	Objets	Quêtes	PNJ
`classic`	World of Warcraft (Vanilla)	1.12.1	2004	15 850	4 243	9 848
`tbc`	The Burning Crusade	2.4.3	2007	25 762	6 374	16 796
`wotlk`	Wrath of the Lich King	3.3.5a	2008	39 133	9 096	25 147

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": 25762,
    "spells": 272,
    "quests": 6374,
    "npcs": 16796,
    "game_objects": 818,
    "item_sets": 18,
    "factions": 58,
    "instances": 51
  },
  "rogue_counts": {
    "items": 6254,
    "quests": 1110,
    "game_objects": 44
  },
  "url": "https://wowdb.assemblee-defias.fr/?version=tbc",
  "api_url": "https://api.wowdb.assemblee-defias.fr/v1/versions/tbc"
}

Un identifiant, trois 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 (/cata/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 trois 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": 15850,
        "spells": 265,
        "quests": 4243,
        "npcs": 9848,
        "game_objects": 591,
        "item_sets": 0,
        "factions": 37,
        "instances": 26
      },
      "rogue_counts": {
        "items": 3619,
        "quests": 614,
        "game_objects": 32
      },
      "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) ou wotlk (3.3.5a).
Valeurs : classic, tbc, wotlk

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": 25762,
    "spells": 272,
    "quests": 6374,
    "npcs": 16796,
    "game_objects": 818,
    "item_sets": 18,
    "factions": 58,
    "instances": 51
  },
  "rogue_counts": {
    "items": 6254,
    "quests": 1110,
    "game_objects": 44
  },
  "url": "https://wowdb.assemblee-defias.fr/?version=tbc",
  "api_url": "https://api.wowdb.assemblee-defias.fr/v1/versions/tbc"
}