.. PlumeIA-API documentation master file, created by
   sphinx-quickstart on Tue Feb 17 15:48:03 2026.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Documentation des APIs
=============================================
Notre plateforme expose plusieurs interfaces de programmation applicative (API) permettant d'interagir avec nos services de manière simple, sécurisée et fiable.
Chaque API requiert une authentification par en-tête HTTP et retourne des réponses au format JSON.
Consultez la documentation détaillée de chaque API :

.. toctree::
   :maxdepth: 2
   
   make-transcription

Authentification
~~~~~~~~~~~~~~~~~~~~
Tous les points de terminaison nécessitent une clé API fournie par Plume à votre organisation. Cette clé doit être transmise dans l'en-tête de chaque requête.

Codes d'erreurs
~~~~~~~~~~~~~~~~~~~~
Les erreurs suivent les codes HTTP standards :

- 400 Bad Request – Paramètres d'entrée invalides
- 401 Unauthorized – Clé API absente ou invalide
- 403 Forbidden – Accès non autorisé à cette ressource
- 404 Not Found – Ressource introuvable
- 500 Internal Server Error – Erreur interne du serveur

Types de fichiers supportés
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Les formats audio et vidéo suivants sont acceptés :

- WAV (``audio/wav``, ``audio/x-wav``)
- MP3 (``audio/mpeg``, ``audio/mp3``)
- MP4 (``audio/mp4``, ``video/mp4``)
- OGG (``audio/ogg``)
- Opus (``audio/opus``)
- FLAC (``audio/flac``, ``audio/x-flac``)
- AAC (``audio/aac``, ``audio/x-aac``)
- M4A (``audio/m4a``, ``audio/x-m4a``, ``audio/mp4a-latm``)
- WebM (``audio/webm``, ``video/webm``)
- AMR (``audio/amr``)
- 3GPP (``audio/3gpp``)
- WMA (``audio/x-ms-wma``)

.. note::
    Vous pouvez également envoyer les fichiers correspondant à une transcription sous format d'archive ``.zip``. 
    Les fichiers seront concaténés en une seule transcription.