-
Notifications
You must be signed in to change notification settings - Fork 5
Rotas não são RESTful #2
Copy link
Copy link
Open
Labels
documentationImprovements or additions to documentationImprovements or additions to documentationgood first issueGood for newcomersGood for newcomers
Description
Activity
Metadata
Metadata
Assignees
Labels
documentationImprovements or additions to documentationImprovements or additions to documentationgood first issueGood for newcomersGood for newcomers
Problema
As rotas listadas no README estão em desacordo com as recomendações para APIs REST.
Veja: https://docs.microsoft.com/pt-br/azure/architecture/best-practices/api-design
Solução proposta
Renomear as rotas de recursos, onde possível, para utilizar apenas substantivos e deixar a semântica da ação realizada a cargo do método HTTP. Por exemplo: (createuser, deluser, updateuser, getuser) -> (user).
Sugestão
Modificar a rota /rateuser para /user/{idUser}/rate
Justificativa: a rating de um usuário é um recurso relacionado e que pertence a um usuário.
Sugestão
Modificar a rota de busca /finduser para /user com o método GET, e incluir no README as possíveis query params que a rota aceita (city, state)
Vi o projeto de vocês no Discord da Rocketseat e reparei nisso no README, e gostaria de tentar contribuir um pouco.