initial commit

docs/architecture/7-external-apis.md

@@ -0,0 +1,68 @@
+# 7. External APIs
+
+## DofusDB API Integration
+
+**Base URL**: `https://api.dofusdb.fr`
+
+### Endpoints Used
+
+| Endpoint | Purpose |
+|----------|---------|
+| `GET /classes` | Liste des classes de personnages |
+| `GET /servers` | Liste des serveurs |
+| `GET /quests` | Liste des quêtes |
+| `GET /dungeons` | Liste des donjons |
+| `GET /achievements` | Liste des succès |
+
+### Integration Service
+
+```typescript
+// src/lib/server/dofusdb.ts
+import NodeCache from 'node-cache';
+
+const cache = new NodeCache({ stdTTL: 3600 }); // 1 hour cache
+const BASE_URL = 'https://api.dofusdb.fr';
+
+interface DofusDbOptions {
+  lang?: 'fr' | 'en';
+  limit?: number;
+}
+
+export async function fetchFromDofusDb<T>(
+  endpoint: string,
+  options: DofusDbOptions = {}
+): Promise<T> {
+  const { lang = 'fr', limit = 100 } = options;
+  const cacheKey = `dofusdb:${endpoint}:${lang}:${limit}`;
+
+  // Check cache
+  const cached = cache.get<T>(cacheKey);
+  if (cached) return cached;
+
+  // Fetch from API
+  const url = new URL(endpoint, BASE_URL);
+  url.searchParams.set('$lang', lang);
+  url.searchParams.set('$limit', limit.toString());
+
+  const response = await fetch(url.toString(), {
+    headers: { 'Accept': 'application/json' },
+  });
+
+  if (!response.ok) {
+    throw new Error(`DofusDB API error: ${response.status}`);
+  }
+
+  const data = await response.json();
+  cache.set(cacheKey, data);
+
+  return data as T;
+}
+
+// Specific fetchers
+export const getClasses = () => fetchFromDofusDb<DofusClass[]>('/classes');
+export const getServers = () => fetchFromDofusDb<DofusServer[]>('/servers');
+export const getQuests = () => fetchFromDofusDb<DofusQuest[]>('/quests');
+export const getDungeons = () => fetchFromDofusDb<DofusDungeon[]>('/dungeons');
+```
+
+---