doc: adding docs

docs/api.md

@@ -0,0 +1,122 @@
+# Documentation des API
+
+## 🔐 Authentification
+
+### POST /api/auth/login
+
+- **Description** : Connexion d'un utilisateur
+- **Body** : `{ email: string, password: string }`
+- **Réponse** : `{ message: string, user: UserData }`
+
+### POST /api/auth/register
+
+- **Description** : Inscription d'un utilisateur
+- **Body** : `{ email: string, password: string }`
+- **Réponse** : `{ message: string, user: UserData }`
+
+## ⚙️ Configuration
+
+### GET /api/komga/config
+
+- **Description** : Récupération de la configuration Komga
+- **Réponse** : `{ url: string, username: string, password: string, userId: string }`
+
+### POST /api/komga/config
+
+- **Description** : Sauvegarde de la configuration Komga
+- **Body** : `{ url: string, username: string, password: string }`
+- **Réponse** : `{ message: string, config: Config }`
+
+### GET /api/komga/ttl-config
+
+- **Description** : Récupération de la configuration TTL du cache
+- **Réponse** : `{ defaultTTL: number, homeTTL: number, ... }`
+
+### POST /api/komga/ttl-config
+
+- **Description** : Sauvegarde de la configuration TTL
+- **Body** : `{ defaultTTL: number, homeTTL: number, ... }`
+- **Réponse** : `{ message: string, config: TTLConfig }`
+
+### GET /api/komga/cache/mode
+
+- **Description** : Récupération du mode de cache actuel
+- **Réponse** : `{ mode: string }`
+
+## 📚 Bibliothèques
+
+### GET /api/komga/libraries
+
+- **Description** : Liste des bibliothèques
+- **Réponse** : `Library[]`
+
+## 📖 Séries
+
+### GET /api/komga/series/[seriesId]
+
+- **Description** : Détails d'une série
+- **Paramètres** : `seriesId` dans l'URL
+- **Réponse** : `Series`
+
+## 📑 Livres
+
+### GET /api/komga/books/[bookId]
+
+- **Description** : Détails d'un livre
+- **Paramètres** : `bookId` dans l'URL
+- **Réponse** : `{ book: Book, pages: number[] }`
+
+### PATCH /api/komga/books/[bookId]/read-progress
+
+- **Description** : Mise à jour de la progression de lecture
+- **Paramètres** : `bookId` dans l'URL
+- **Body** : `{ page: number, completed: boolean }`
+- **Réponse** : `{ message: string }`
+
+## 🖼️ Images
+
+### GET /api/komga/images/series/[seriesId]/thumbnail
+
+- **Description** : Miniature d'une série
+- **Paramètres** : `seriesId` dans l'URL
+- **Réponse** : Image
+
+### GET /api/komga/images/books/[bookId]/thumbnail
+
+- **Description** : Miniature d'un livre
+- **Paramètres** : `bookId` dans l'URL
+- **Réponse** : Image
+
+### GET /api/komga/images/books/[bookId]/pages/[pageNumber]
+
+- **Description** : Page d'un livre
+- **Paramètres** : `bookId` et `pageNumber` dans l'URL
+- **Réponse** : Image
+
+### GET /api/komga/images/books/[bookId]/pages/[pageNumber]/thumbnail
+
+- **Description** : Miniature d'une page
+- **Paramètres** : `bookId` et `pageNumber` dans l'URL
+- **Réponse** : Image
+
+## ⭐ Favoris
+
+### GET /api/komga/favorites
+
+- **Description** : Liste des IDs des séries favorites
+- **Réponse** : `string[]`
+
+## 🔧 Préférences
+
+### GET /api/preferences
+
+- **Description** : Récupération des préférences utilisateur
+- **Réponse** : `Preferences`
+
+## 🧪 Test
+
+### POST /api/komga/test
+
+- **Description** : Test de connexion au serveur Komga
+- **Body** : `{ serverUrl: string, username: string, password: string }`
+- **Réponse** : `{ message: string, librariesCount: number }`