APIRéférence

Recherche

Recherche plein texte dans toute la base, par pertinence, tous types et toutes versions.

Une seule requête pour chercher dans toute la base : noms et infobulles, tous types et toutes versions, ou ceux que vous choisissez. Pour filtrer finement un seul type, préférez sa liste et son paramètre q.

Routes

GET/v1/search

Pertinence#

Le nom exact (avec ou sans article : « aldor » trouve « L’Aldor »).
Les noms qui commencent par le texte cherché.
Le score du texte, où le nom pèse dix fois plus que l’infobulle.
Le nom, par ordre alphabétique.

Chaque mot doit commencer un mot de la fiche ; les mots vides (« de », « la ») sont ignorés quand d’autres mots suffisent. Une recherche d’une ou deux lettres ne porte que sur les noms. Un numéro (q=5191) trouve la fiche de ce numéro dans chaque type et chaque version.

Rechercher#

GET/v1/search

Recherche plein texte dans toute la base : noms et infobulles, toutes versions et tous types confondus (sauf filtres). Résultats par pertinence : nom exact d’abord, puis début du nom, puis score du texte. Un numéro du jeu trouve la fiche de ce numéro dans chaque type et chaque version. Chaque résultat est l’objet résumé de son type (champ object).

Paramètres de requête#

qchaîneobligatoire
Texte à chercher : nom, mot de l’infobulle, ou numéro du jeu. Obligatoire, 120 caractères au plus.
versioncodes séparés par des virgules
Versions où chercher, séparées par des virgules (toutes par défaut).
Valeurs : classic, tbc, wotlk
typecodes séparés par des virgules
Types de fiches, séparés par des virgules : item, spell, quest, npc, game_object, item_set, faction (tous par défaut).
Valeurs : item, spell, quest, npc, game_object, item_set, faction
roguebooléen
true : seulement les objets, quêtes et objets du monde utiles au voleur ; false : seulement les autres. Absent : tout (par défaut).
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") de résumés de fiches de tous types (champ object : item, npc…), par pertinence, paginée par curseur.

GET /v1/search

curl -G https://api.wowdb.assemblee-defias.fr/v1/search \
  --data-urlencode "q=cape de la confrérie" \
  -d type=item \
  -d version=classic \
  -d limit=1

Réponse200JSON

{
  "object": "list",
  "data": [
    {
      "object": "item",
      "id": 5193,
      "key": "classic:item:5193",
      "version": "classic",
      "name": "Cape de la confrérie",
      "quality": "rare",
      "quality_name": "Rare",
      "icon": "https://wowdb.assemblee-defias.fr/database-icons/inv_misc_cape_08.jpg",
      "item_level": 25,
      "required_level": 20,
      "slot": "back",
      "slot_name": "Dos",
      "type": "cloth",
      "type_name": "Tissu",
      "weapon": null,
      "sell_price": 940,
      "rogue": true,
      "internal": false,
      "tooltip": [
        "Cape de la confrérie",
        "Niveau d'objet 25",
        "Lié quand ramassé",
        "Dos",
        "Tissu",
        "Armure : 21",
        "+6 Agilité",
        "+3 Endurance",
        "Niveau 20 requis"
      ],
      "url": "https://wowdb.assemblee-defias.fr/?id=classic:item:5193",
      "api_url": "https://api.wowdb.assemblee-defias.fr/v1/classic/items/5193"
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "url": "https://api.wowdb.assemblee-defias.fr/v1/search?q=cape%20de%20la%20confr%C3%A9rie&type=item&version=classic"
}