initial commit

docs/prd/dofusdb-api-reference.md

@@ -0,0 +1,77 @@
+# DofusDB API Reference
+
+Documentation de l'API externe utilisée pour l'Epic 6.
+
+## Base URL
+
+`https://api.dofusdb.fr/`
+
+## Caractéristiques techniques
+
+- **Framework:** FeathersJS (REST API)
+- **Pagination:** `$limit`, `$skip` (défaut: limit=10)
+- **Filtrage:** Style MongoDB (`$regex`, `$in`, `$gt`, etc.)
+- **Multilingue:** `name.fr`, `name.en`, `name.de`, `name.es`, `name.pt`
+- **Authentification:** Aucune (API publique)
+
+## Endpoints disponibles
+
+| Endpoint | Total | Champs clés |
+|----------|-------|-------------|
+| `/dungeons` | 187 | id, name, optimalPlayerLevel, monsters[], subarea |
+| `/quests` | 1978 | id, name, categoryId, levelMin, levelMax, steps[], rewards[] |
+| `/achievements` | 2788 | id, name, description, level, points, categoryId, rewards[] |
+| `/monsters` | 5093 | id, name, level, isBoss, stats, drops[], subareas[] |
+| `/items` | — | id, name, typeId (23 = Dofus trophées) |
+| `/quest-categories` | 43+ | id, name (régions, types de quêtes) |
+| `/achievement-categories` | 129 | id, name, parentId |
+
+## Mapping pour le PRD
+
+| Besoin PRD | Endpoint DofusDB | Query |
+|------------|------------------|-------|
+| **Donjons** | `/dungeons` | `?$limit=200` |
+| **Recherchés** | `/quests` | `?categoryId=6` |
+| **Items Dofus** | `/items` | `?typeId=23&name.fr[$regex]=Dofus` |
+| **Succès donjons** | `/achievements` | `?categoryId=3` |
+
+## Dofus identifiés
+
+| ID Item | Nom |
+|---------|-----|
+| 739 | Dofus Turquoise |
+| 694 | Dofus Pourpre |
+| 737 | Dofus Émeraude |
+| 7043 | Dofus des Glaces |
+| 18043 | Dofus Abyssal |
+| 8698 | Dofus Nébuleux |
+| 7112 | Dofus Tacheté |
+| 6980 | Dofus Vulbis |
+| 7754 | Dofus Ocre |
+| 7114 | Dofus Ébène |
+| 7115 | Dofus Ivoire |
+
+## Exemples de requêtes
+
+```bash
+# Tous les donjons
+curl "https://api.dofusdb.fr/dungeons?$limit=200"
+
+# Quêtes de recherchés (Avis de recherche)
+curl "https://api.dofusdb.fr/quests?categoryId=6"
+
+# Items Dofus
+curl "https://api.dofusdb.fr/items?typeId=23&name.fr[\$regex]=Dofus"
+
+# Monstres boss
+curl "https://api.dofusdb.fr/monsters?isBoss=true&$limit=50"
+```
+
+## Notes d'implémentation
+
+- Les quêtes Dofus ne sont pas directement liées aux items Dofus dans l'API → nécessite un mapping manuel
+- Les recherchés sont sous `categoryId=6` dans `/quests`
+- Les noms sont multilingues : utiliser `name.fr` pour le français
+- Pagination recommandée pour les gros volumes (achievements, monsters)
+
+---