Rédiger une documentation technique d'API

Génère la documentation technique complète pour l'endpoint API suivant : Méthode : [GET/POST/PUT/DELETE] Route : [/api/v1/...] Description : [DESCRIPTION] Inclus : description, authentification requise, paramètres (query/body) avec types et validation, format de réponse (succès + erreurs) avec exemples JSON, codes HTTP possibles, exemple cURL, et notes sur le rate limiting. Format Markdown.