2
respostas

método http usado no curso Node.js: avançando em APIs REST com controle de versões

na aula 6 do módulo 3, o instrutor usa o método post para atualizar uma única informação (estoque de u produto) no banco de dados, porém isso não segue a convenção REST, pois o método usado para atualização parcial de dados é o patch, alguém poderia confirmar isso para mim?

2 respostas

Eu penso que como essa atualização foi mapeada para uma ação específica que é "diminuir o estoque", usar o POST é válido. Mas eu escolheria o PUT, tomando como exemplo a API Rest do GitHub: https://developer.github.com/v3/gists/#star-a-gist para tentar seguir mais fielmente os princípios RESTFul.

Acho que PATCH seria interessante se essa ação pudesse ser mapeada de forma que o endpoint recebesse e retornasse, no corpo, algo como { estoque: x }

Quando tenho essas dúvidas de design de API sempre procuro fazer como o Micael acima citou, busco referências de boas praicas em APIs que tem uma popularidade e aceitação bacana da comunidade. Além da do Github linkada acima, posso complementar com a do Stripe.

É sempre bom ter essas inspirações para ajudar a compor algo que torne o seu usuário (nesse caso, outros desenvolvedores) mais satisfeito com as integrações criadas.