Grosse mise à jour de la doc de l'API

Mise à jour de la doc de l'API (à propos des routes du UsersBundle).
Petite MàJ du contrôleur pour renvoyer des messages d'erreurs plus
utiles