# DejaVu API v1 ## Référence API ### Introduction - [Référence API](https://docs.dejavu.plus/fr/api-reference/introduction.md): Référence complète de l’API v1 DejaVu - [Authentification](https://docs.dejavu.plus/fr/api-reference/authentication.md): Clés API, Bearer et Device Flow ### Auth - [Demander un code d'appareil](https://docs.dejavu.plus/fr/api-reference/auth/request-device-code.md): First authentication step for devices without a keyboard (TV, etc.). - [Obtenir le QR code d'un appareil](https://docs.dejavu.plus/fr/api-reference/auth/request-device-qr.md): Returns a PNG containing the verification URL associated with a pending user_code. - [Échanger le code d'appareil](https://docs.dejavu.plus/fr/api-reference/auth/exchange-device-token.md): Polling step to check whether the user has authorized the device. - [Vérifier le code utilisateur](https://docs.dejavu.plus/fr/api-reference/auth/verify-device-code.md): Called by the user's browser to validate a `user_code` before approval. - [Approuver un appareil](https://docs.dejavu.plus/fr/api-reference/auth/approve-device-code.md): Called from the user account. Requires the DejaVu browser session. ### Collection - [Récupérer la collection](https://docs.dejavu.plus/fr/api-reference/collection/get-collection.md): Returns all items in your collection with optional pagination. - [Ajouter à la collection](https://docs.dejavu.plus/fr/api-reference/collection/add-to-collection.md): Adds a movie or TV show to your collection. **Requires a secret key** (`sk_...`). - [Supprimer de la collection](https://docs.dejavu.plus/fr/api-reference/collection/remove-from-collection.md): Removes an item from your collection. **Requires a secret key** (`sk_...`). ### History - [Récupérer l’historique](https://docs.dejavu.plus/fr/api-reference/history/get-history.md): Returns the user's watch history. - [Ajouter à l’historique](https://docs.dejavu.plus/fr/api-reference/history/add-to-history.md): Records a watch in history. **Requires a secret key** (`sk_...`). - [Supprimer de l’historique](https://docs.dejavu.plus/fr/api-reference/history/remove-from-history.md): Removes a history entry. **Requires a secret key** (`sk_...`). ### Favorites - [Récupérer les favoris](https://docs.dejavu.plus/fr/api-reference/favorites/get-favorites.md): Returns the user's favorites. - [Ajouter aux favoris](https://docs.dejavu.plus/fr/api-reference/favorites/add-to-favorites.md): Adds a movie or TV show to favorites. **Requires a secret key** (`sk_...`). - [Supprimer des favoris](https://docs.dejavu.plus/fr/api-reference/favorites/remove-from-favorites.md): Removes an item from favorites. **Requires a secret key** (`sk_...`). ### Ratings - [Récupérer les notes](https://docs.dejavu.plus/fr/api-reference/ratings/get-ratings.md): Returns ratings given by the user. - [Ajouter ou modifier une note](https://docs.dejavu.plus/fr/api-reference/ratings/upsert-rating.md): Assigns or updates a rating (1-10) with an optional review. **Requires a secret key** (`sk_...`). - [Supprimer une note](https://docs.dejavu.plus/fr/api-reference/ratings/delete-rating.md): Removes an existing rating. **Requires a secret key** (`sk_...`). ### Watchlist - [Récupérer la watchlist](https://docs.dejavu.plus/fr/api-reference/watchlist/get-watchlist.md): Returns the list of content to watch. - [Ajouter à la watchlist](https://docs.dejavu.plus/fr/api-reference/watchlist/add-to-watchlist.md): Adds a movie or TV show to the watchlist. **Requires a secret key** (`sk_...`). - [Supprimer de la watchlist](https://docs.dejavu.plus/fr/api-reference/watchlist/remove-from-watchlist.md): Removes an item from the watchlist. **Requires a secret key** (`sk_...`). ### Scrobble - [Sessions de lecture en cours](https://docs.dejavu.plus/fr/api-reference/scrobble/get-scrobble-sessions.md): Returns active playback sessions (currently playing). - [Mettre à jour la progression](https://docs.dejavu.plus/fr/api-reference/scrobble/update-scrobble.md): Updates playback progress for a movie or episode. If progress exceeds **90%**, the content is automatically marked as watched in history. **Requires a secret key** (`sk_...`). - [Supprimer une session](https://docs.dejavu.plus/fr/api-reference/scrobble/delete-scrobble.md): Ends a playback session without marking it as watched. **Requires a secret key** (`sk_...`). ### Up Next - [Séries à suivre (Up Next)](https://docs.dejavu.plus/fr/api-reference/upnext/get-up-next.md): Returns the next episodes to watch for shows in progress. ### Dashboard - [Configuration du tableau de bord](https://docs.dejavu.plus/fr/api-reference/dashboard/get-dashboard-config.md): Returns the user's dashboard widget configuration. - [Contenu unifié de widget](https://docs.dejavu.plus/fr/api-reference/dashboard/get-dashboard-widget-content.md): Acts as a proxy to return the content of a specific widget. ### Lists - [Récupérer les listes](https://docs.dejavu.plus/fr/api-reference/lists/get-lists.md): Returns all of the user's custom lists. - [Créer une liste](https://docs.dejavu.plus/fr/api-reference/lists/create-list.md): Creates a new custom list. **Requires a secret key** (`sk_...`). - [Récupérer les éléments d'une liste](https://docs.dejavu.plus/fr/api-reference/lists/get-list-items.md): Returns the items in a list with pagination. - [Ajouter un élément à une liste](https://docs.dejavu.plus/fr/api-reference/lists/add-item-to-list.md): Adds a movie or TV show to a list. **Requires a secret key** (`sk_...`). - [Retirer un élément d'une liste](https://docs.dejavu.plus/fr/api-reference/lists/remove-item-from-list.md): Removes a movie or TV show from a list. **Requires a secret key** (`sk_...`). ### User - [Récupérer le profil et les statistiques du compte](https://docs.dejavu.plus/fr/api-reference/user/get-profile.md): Returns user profile information and overall statistics (time spent, number of movies, etc.). ### Media - [Résoudre un média](https://docs.dejavu.plus/fr/api-reference/media/resolve-media.md): Finds a media item from an IMDb ID, a TMDB ID and type, a title/year, or episode context. - [Récupérer le statut de médias](https://docs.dejavu.plus/fr/api-reference/media/get-media-status.md): Returns user status for a batch of movies, TV shows, or episodes. ### Channels - [Lister les chaînes](https://docs.dejavu.plus/fr/api-reference/channels/get-channels.md) - [Récupérer une chaîne](https://docs.dejavu.plus/fr/api-reference/channels/get-channel.md) ### Connectors - [Lister les connecteurs approuvés](https://docs.dejavu.plus/fr/api-reference/connectors/get-connectors.md): Public endpoint used by the browser extension. - [Soumettre un connecteur](https://docs.dejavu.plus/fr/api-reference/connectors/submit-connector.md): Submits a connector for review. Limit: 5 submissions per hour per user. ### Kodi - [Importer une bibliothèque Kodi](https://docs.dejavu.plus/fr/api-reference/kodi/import.md) ## OpenAPI Specs - [openapi](/api-reference/openapi.json) - [openapi](/en/api-reference/openapi.json) > The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages. ## Indexes - [English (41 pages)](https://docs.dejavu.plus/_llms/en.md): Documentation for English.