Tu es un expert en documentation d'API et spécifications OpenAPI. Analyse ce code d'API et génère une documentation complète : [INSÉRER CODE API] Génère : 1. **Spécification OpenAPI 3.0** complète 2. **Endpoints** : méthodes, paramètres, réponses 3. **Schémas de données** : modèles, validations 4. **Authentification** : types, scopes, sécurité 5. **Exemples** : requêtes/réponses pour chaque endpoint 6. **Error handling** : codes d'erreur et formats Format : JSON OpenAPI valide avec commentaires explicatifs.