# API de WoWDB des Défias

> API publique en lecture seule, sans clé, de WoWDB des Défias : objets, sorts, quêtes, PNJ, objets du monde, ensembles, réputations, donjons et raids de World of Warcraft Vanilla (1.12.1), TBC (2.4.3) et WotLK (3.3.5a), en français. Adresse de base : https://api.wowdb.assemblee-defias.fr/v1.

Réponses JSON typées (champ `object`), noms de champs anglais en snake_case, textes du jeu en français ; version du jeu dans le chemin (`/classic/items/5191`) ; listes paginées par curseur (`has_more`, `next_cursor`) ; filtre voleur facultatif `rogue=true` ; CORS ouvert ; ETag ; limite de 120 requêtes par minute par adresse IP. Chaque page ci-dessous est en Markdown, avec les exemples dans neuf langages et de vraies réponses.

## Pour commencer

- [Introduction](https://docs.wowdb.assemblee-defias.fr/index.md): 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é.
- [Authentification](https://docs.wowdb.assemblee-defias.fr/authentification.md): Aucune clé, aucun compte : l’API de WoWDB est publique. Identifiez simplement votre application.
- [Versions du jeu](https://docs.wowdb.assemblee-defias.fr/versions.md): Vanilla, The Burning Crusade et Wrath of the Lich King : la version du jeu fait partie de chaque adresse.
- [Pagination](https://docs.wowdb.assemblee-defias.fr/pagination.md): Listes paginées par curseur, comme Stripe : has_more, next_cursor, sans doublon ni trou.
- [Filtres et filtre voleur](https://docs.wowdb.assemblee-defias.fr/filtres.md): Filtrer les listes par qualité, emplacement, type, niveau, camp… et garder ce qui sert au voleur avec rogue=true.
- [Erreurs](https://docs.wowdb.assemblee-defias.fr/erreurs.md): Statuts HTTP et objet error homogène : type, code, message en français, param et doc_url.
- [Limites de débit](https://docs.wowdb.assemblee-defias.fr/limites.md): 120 requêtes par minute et 3000 par heure par adresse IP, avec les en-têtes RateLimit et Retry-After.
- [Cache et ETag](https://docs.wowdb.assemblee-defias.fr/cache.md): Cache-Control, ETag et 304 Not Modified : économisez vos requêtes et vos quotas.
- [CORS](https://docs.wowdb.assemblee-defias.fr/cors.md): L’API s’appelle directement depuis le JavaScript de n’importe quel site : Access-Control-Allow-Origin: *.

## Référence

- [Objets](https://docs.wowdb.assemblee-defias.fr/items.md): Les 80 745 objets de Vanilla, TBC et WotLK : qualité, niveaux, emplacement, dégâts, prix, infobulle, sources, filtre voleur.
- [Sorts](https://docs.wowdb.assemblee-defias.fr/spells.md): Les sorts et talents du voleur, avec leurs rangs et niveaux requis.
- [Quêtes](https://docs.wowdb.assemblee-defias.fr/quests.md): Les 19 713 quêtes : objectifs, récompenses, PNJ de début et de fin, chaînes, catégories.
- [PNJ](https://docs.wowdb.assemblee-defias.fr/npcs.md): Les PNJ : boss et rencontres, butin, objets vendus, quêtes, réputation, emplacements sur les cartes.
- [Objets du monde](https://docs.wowdb.assemblee-defias.fr/game-objects.md): Coffres, coffres verrouillés, objets de quête, gisements et herbes, avec la compétence requise, le butin et les cartes.
- [Ensembles](https://docs.wowdb.assemblee-defias.fr/item-sets.md): Les ensembles d’armure : pièces et bonus.
- [Réputations](https://docs.wowdb.assemblee-defias.fr/factions.md): Les réputations : rangs, récompenses par rang avec intendants et prix, quêtes et monstres qui les font monter.
- [Donjons et raids](https://docs.wowdb.assemblee-defias.fr/instances.md): Donjons et raids : niveaux, accès, rencontres dans l’ordre du jeu, quêtes et tout le butin par difficulté.
- [Recherche](https://docs.wowdb.assemblee-defias.fr/search.md): Recherche plein texte dans toute la base, par pertinence, tous types et toutes versions.
- [Statistiques](https://docs.wowdb.assemblee-defias.fr/stats.md): Nombre de fiches par version et par ressource, et date des données.

## Outils

- [Bibliothèques clientes](https://docs.wowdb.assemblee-defias.fr/bibliotheques.md): Les clients officiels de WoWDB, d’un seul fichier et sans dépendance, et la génération de clients par OpenAPI.
- [OpenAPI](https://docs.wowdb.assemblee-defias.fr/openapi.md): La spécification OpenAPI 3.1 complète de l’API, vérifiée contre les vraies réponses.
- [llms.txt et Markdown](https://docs.wowdb.assemblee-defias.fr/llms.md): La documentation pour les assistants IA : Markdown de chaque page, llms.txt, llms-full.txt et « Copier pour un LLM ».
- [Journal des modifications](https://docs.wowdb.assemblee-defias.fr/journal.md): Les versions de l’API et leurs changements.
- [Conditions d’usage](https://docs.wowdb.assemblee-defias.fr/conditions.md): Usage libre et raisonnable, citation de WoWDB des Défias, données du jeu © Blizzard Entertainment.

## Optional

- [Toute la documentation en un fichier](https://docs.wowdb.assemblee-defias.fr/llms-full.txt): les pages ci-dessus réunies
- [Spécification OpenAPI 3.1](https://api.wowdb.assemblee-defias.fr/v1/openapi.json): chaque route, paramètre et champ
- [WoWDB des Défias](https://wowdb.assemblee-defias.fr/llms.txt): le site, ses fiches et ses adresses