Pesquisei um pouco sobre o modelo de API REST, mas dentre muitas dúvidas que eu tinha, me restou uma que é essencialmente importante.
O pessoal sempre dava exemplos de modelos de rotas parecidas com isso:
https://api.dominio.com.br/account[/{id}]
GET -> obtem o(s) usuário(s)
POST -> insere um novo usuário
PUT -> atualiza o usuário
DELETE -> remove o usuário
Até aí funciona muito bem, eu tenho a opção de manusear todos os usuários ou apenas um, mas só através do ID.
- Se eu quiser selecionar pelo e-mail ou pelo nome de usuário? Como deveria ser feito?
- Se eu precisar passar parâmetros mais avançados para a consulta, como um WHERE ou um ORDER BY ou até mesmo um LIMIT, como fazer?
@Edit
Se possível, também gostaria de saber o seguinte: em operações um pouco menos abstratas como enviar um e-mail de recuperação de senha, os processos necessários para tal devem ser feitos na aplicação cliente (que teria que fazer várias requisições a API) ou deve-se criar uma rota que quando chamada realize todas as operações necessárias e entregue uma resposta pronta a aplicação cliente?
A operações para enviar um e-mail de recuperação de senha, são mais ou menos no modelo abaixo:
- Verifica se o usuário existe;
- Verifica se o código de recuperação gerado pela aplicação já foi gerado antes para outro usuário, para evitar códigos duplicados;
- Registra o código de recuperação;
- Obtém o modelo de e-mail para recuperações de senha;
- Envia o e-mail.
?foo=bar&baz=foobar
, mas é claro que REST é REST, uma chamada REST não vai fazer uma série de coisar diferentes, então muita coisa vc vai poder acertas no proprio PATH. Pra resumir, você quer multiplas ações e essas ações com certeza ficam bem resolvidas se divididas em diferentes URLs (creio que o Slim tenha grupo de rotas, o que deve ajudar a se organizar) – Guilherme Nascimento♦ 13/09/17 às 16:57