APIRéférence

Sorts

Les sorts et talents du voleur, avec leurs rangs et niveaux requis.

Les sorts et talents du voleur cités par les guides de L’Assemblée des Défias, dans chaque version, avec tous leurs rangs. Chaque rang est une fiche (son propre identifiant) ; ranks les relie.

Routes

GET/v1/{version}/spells
GET/v1/{version}/spells/{id}

L’objet spell#

Un sort ou un talent, rang par rang.

Champs#

objectchaîne
Type d’objet, toujours « spell ».
Valeurs : spell
identier
Identifiant de le sort : son numéro dans le jeu (entrée de la base du jeu), le même dans les trois versions quand le sort y existe.
keychaîne
Clé WoWDB, unique dans toute la base : « <version>:<type>:<id> » (classic:spell:1784).
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.
rankentier ou null
Rang du sort ; null pour un sort sans rang.
required_levelentier ou null
Niveau requis.
talentbooléen
Vrai pour un talent.
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 le sort dans l’API.

Fiche seulement (GET …/{id})#

rankstableau d’objets
Tous les rangs de ce sort dans la même version.
3 attributs enfants
- rankentier
  Rang.
- required_levelentier ou null
  Niveau requis.
- spellRef
  Fiche du rang.
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 : sort200JSON

{
  "object": "spell",
  "id": 1784,
  "key": "classic:spell:1784",
  "version": "classic",
  "name": "Camouflage",
  "icon": "https://wowdb.assemblee-defias.fr/database-icons/ability_stealth.jpg",
  "rank": 1,
  "required_level": 1,
  "talent": false,
  "tooltip": [
    "Camouflage",
    "Instantanée",
    "10 s de recharge",
    "Requiert Voleur",
    "Niveau 1 requis",
    "Permet au voleur de se déplacer silencieusement, mais réduit sa vitesse de 50%. Dure jusqu'à ce qu'il soit annulé."
  ],
  "url": "https://wowdb.assemblee-defias.fr/?id=classic:spell:1784",
  "api_url": "https://api.wowdb.assemblee-defias.fr/v1/classic/spells/1784",
  "ranks": [
    {
      "rank": 1,
      "required_level": 1,
      "spell": {
        "object": "spell",
        "id": 1784,
        "version": "classic",
        "name": "Camouflage",
        "url": "https://wowdb.assemblee-defias.fr/?id=classic:spell:1784",
        "api_url": "https://api.wowdb.assemblee-defias.fr/v1/classic/spells/1784"
      }
    },
    {
      "rank": 2,
      "required_level": 20,
      "spell": {
        "object": "spell",
        "id": 1785,
        "version": "classic",
        "name": "Camouflage",
        "url": "https://wowdb.assemblee-defias.fr/?id=classic:spell:1785",
        "api_url": "https://api.wowdb.assemblee-defias.fr/v1/classic/spells/1785"
      }
    },
    {
      "rank": 3,
      "required_level": 40,
      "spell": {
        "object": "spell",
        "id": 1786,
        "version": "classic",
        "name": "Camouflage",
        "url": "https://wowdb.assemblee-defias.fr/?id=classic:spell:1786",
        "api_url": "https://api.wowdb.assemblee-defias.fr/v1/classic/spells/1786"
      }
    },
    {
      "rank": 4,
      "required_level": 60,
      "spell": {
        "object": "spell",
        "id": 1787,
        "version": "classic",
        "name": "Camouflage",
        "url": "https://wowdb.assemblee-defias.fr/?id=classic:spell:1787",
        "api_url": "https://api.wowdb.assemblee-defias.fr/v1/classic/spells/1787"
      }
    }
  ],
  "versions": [
    {
      "object": "spell",
      "id": 1784,
      "version": "classic",
      "name": "Camouflage",
      "url": "https://wowdb.assemblee-defias.fr/?id=classic:spell:1784",
      "api_url": "https://api.wowdb.assemblee-defias.fr/v1/classic/spells/1784"
    },
    {
      "object": "spell",
      "id": 1784,
      "version": "tbc",
      "name": "Camouflage",
      "url": "https://wowdb.assemblee-defias.fr/?id=tbc:spell:1784",
      "api_url": "https://api.wowdb.assemblee-defias.fr/v1/tbc/spells/1784"
    },
    {
      "object": "spell",
      "id": 1784,
      "version": "wotlk",
      "name": "Camouflage",
      "url": "https://wowdb.assemblee-defias.fr/?id=wotlk:spell:1784",
      "api_url": "https://api.wowdb.assemblee-defias.fr/v1/wotlk/spells/1784"
    }
  ],
  "guides": []
}

Lister les sorts#

GET/v1/{version}/spells

Les sorts et talents du voleur cités par les guides, avec tous leurs rangs.

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.
talentbooléen
true : talents seulement ; false : sorts seulement.
min_levelentier
Niveau requis minimum (1 à 100).
max_levelentier
Niveau requis maximum (1 à 100).
sortchaîne
Ordre : name, required_level ; « - » 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, required_level, -required_level
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 spell, paginée par curseur.

GET /v1/{version}/spells

curl -G https://api.wowdb.assemblee-defias.fr/v1/classic/spells \
  -d q=camouflage \
  -d limit=2

Réponse200JSON

{
  "object": "list",
  "data": [
    {
      "object": "spell",
      "id": 1784,
      "key": "classic:spell:1784",
      "version": "classic",
      "name": "Camouflage",
      "icon": "https://wowdb.assemblee-defias.fr/database-icons/ability_stealth.jpg",
      "rank": 1,
      "required_level": 1,
      "talent": false,
      "tooltip": [
        "Camouflage",
        "Instantanée",
        "10 s de recharge",
        "Requiert Voleur",
        "Niveau 1 requis",
        "Permet au voleur de se déplacer silencieusement, mais réduit sa vitesse de 50%. Dure jusqu'à ce qu'il soit annulé."
      ],
      "url": "https://wowdb.assemblee-defias.fr/?id=classic:spell:1784",
      "api_url": "https://api.wowdb.assemblee-defias.fr/v1/classic/spells/1784"
    },
    {
      "object": "spell",
      "id": 1785,
      "key": "classic:spell:1785",
      "version": "classic",
      "name": "Camouflage",
      "icon": "https://wowdb.assemblee-defias.fr/database-icons/ability_stealth.jpg",
      "rank": 2,
      "required_level": 20,
      "talent": false,
      "tooltip": [
        "Camouflage",
        "Instantanée",
        "10 s de recharge",
        "Requiert Voleur",
        "Niveau 20 requis",
        "Permet au voleur de se déplacer silencieusement, mais réduit sa vitesse de 40%. Dure jusqu'à ce qu'il soit annulé."
      ],
      "url": "https://wowdb.assemblee-defias.fr/?id=classic:spell:1785",
      "api_url": "https://api.wowdb.assemblee-defias.fr/v1/classic/spells/1785"
    }
  ],
  "has_more": true,
  "next_cursor": "eyJrIjpbImNhbW91ZmxhZ2UiLCJjbGFzc2ljOnNwZWxsOjE3ODUiXSwiaCI6ImtVSFVnZVpFeFAifQ",
  "url": "https://api.wowdb.assemblee-defias.fr/v1/classic/spells?q=camouflage"
}

Obtenir un sort#

GET/v1/{version}/spells/{id}

La fiche complète du sort : 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 du sort.

Renvoie#

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

GET /v1/{version}/spells/{id}

curl https://api.wowdb.assemblee-defias.fr/v1/classic/spells/1784

Réponse200JSON

{
  "object": "spell",
  "id": 1784,
  "key": "classic:spell:1784",
  "version": "classic",
  "name": "Camouflage",
  "icon": "https://wowdb.assemblee-defias.fr/database-icons/ability_stealth.jpg",
  "rank": 1,
  "required_level": 1,
  "talent": false,
  "tooltip": [
    "Camouflage",
    "Instantanée",
    "10 s de recharge",
    "Requiert Voleur",
    "Niveau 1 requis",
    "Permet au voleur de se déplacer silencieusement, mais réduit sa vitesse de 50%. Dure jusqu'à ce qu'il soit annulé."
  ],
  "url": "https://wowdb.assemblee-defias.fr/?id=classic:spell:1784",
  "api_url": "https://api.wowdb.assemblee-defias.fr/v1/classic/spells/1784",
  "ranks": [
    {
      "rank": 1,
      "required_level": 1,
      "spell": {
        "object": "spell",
        "id": 1784,
        "version": "classic",
        "name": "Camouflage",
        "url": "https://wowdb.assemblee-defias.fr/?id=classic:spell:1784",
        "api_url": "https://api.wowdb.assemblee-defias.fr/v1/classic/spells/1784"
      }
    },
    {
      "rank": 2,
      "required_level": 20,
      "spell": {
        "object": "spell",
        "id": 1785,
        "version": "classic",
        "name": "Camouflage",
        "url": "https://wowdb.assemblee-defias.fr/?id=classic:spell:1785",
        "api_url": "https://api.wowdb.assemblee-defias.fr/v1/classic/spells/1785"
      }
    },
    {
      "rank": 3,
      "required_level": 40,
      "spell": {
        "object": "spell",
        "id": 1786,
        "version": "classic",
        "name": "Camouflage",
        "url": "https://wowdb.assemblee-defias.fr/?id=classic:spell:1786",
        "api_url": "https://api.wowdb.assemblee-defias.fr/v1/classic/spells/1786"
      }
    },
    {
      "rank": 4,
      "required_level": 60,
      "spell": {
        "object": "spell",
        "id": 1787,
        "version": "classic",
        "name": "Camouflage",
        "url": "https://wowdb.assemblee-defias.fr/?id=classic:spell:1787",
        "api_url": "https://api.wowdb.assemblee-defias.fr/v1/classic/spells/1787"
      }
    }
  ],
  "versions": [
    {
      "object": "spell",
      "id": 1784,
      "version": "classic",
      "name": "Camouflage",
      "url": "https://wowdb.assemblee-defias.fr/?id=classic:spell:1784",
      "api_url": "https://api.wowdb.assemblee-defias.fr/v1/classic/spells/1784"
    },
    {
      "object": "spell",
      "id": 1784,
      "version": "tbc",
      "name": "Camouflage",
      "url": "https://wowdb.assemblee-defias.fr/?id=tbc:spell:1784",
      "api_url": "https://api.wowdb.assemblee-defias.fr/v1/tbc/spells/1784"
    },
    {
      "object": "spell",
      "id": 1784,
      "version": "wotlk",
      "name": "Camouflage",
      "url": "https://wowdb.assemblee-defias.fr/?id=wotlk:spell:1784",
      "api_url": "https://api.wowdb.assemblee-defias.fr/v1/wotlk/spells/1784"
    }
  ],
  "guides": []
}