Bonjour tout le monde,
Je sollicite votre aide par rapport à une problématique à laquelle je fais face dans le cadre de mes développement web.
J'ai lu les bonnes pratiques de nommage web services Rest mais souvent ils utilisent des exemples simple, par exemple :
1 2 3
| GET /cars -> donne toutes les voitures
PUT /cars/1 -> met à jour la voiture avec l'id 1
etc... |
Donc ok, on nomme la méthode Rest "cars" parce qu'on gère des ressources cars. Mais qu'en est-il des opérations plus "complexes" ??
Par exemple, j'ai un système où des users ont des comptes. Je veux créer une méthode Get qui permet de vérifier si le compte qu'on passerait en entrée existe pour cette personne.
Donc j'ai créé :
GET /users/1/10 -> retourne les infos users de la personne avec id 1 si elle a un compte avec id 10 dans la base
Est-ce une bonne chose de nommer la méthode "/users" ? Sachant que le véritable objet de la méthode c'est pas vraiment de donner les informations de la personne mais plus de regarder si le compte qu'on passe existe pour cette personne.
En d'autres mots, est-ce qu'on doit nommer les méthodes Rest par rapport aux données de la ressource qu'on retourne ou alors par rapport à l'objet de la méthode ?
Dans notre cas, ça donnerait "/checkIfAccountExists" par exemple.
Partager