Toda vez que você abre uma página ou um app consulta o servidor, uma requisição HTTP é enviada. Ela leva um método, que diz qual ação você quer executar. Entender os principais ajuda a ler documentação de APIs e a achar erros.
Os quatro métodos mais usados
- GET: pede para ler um recurso, como a lista de produtos ou os dados de um usuário. Não deve alterar nada no servidor.
- POST: envia dados para criar algo novo, como um cadastro, um pedido ou um comentário.
- PUT: substitui um recurso existente pelos dados enviados, normalmente o objeto completo.
- DELETE: pede para remover um recurso.
Existe ainda o PATCH, usado para atualizar apenas parte de um recurso, e outros métodos menos frequentes no começo do aprendizado.
Um exemplo com uma lista de tarefas
Imagine uma API de tarefas, com endereços que variam conforme o projeto:
- Ver todas as tarefas: GET na rota de tarefas.
- Criar uma tarefa: POST na mesma rota, com o texto da tarefa no corpo.
- Atualizar uma tarefa: PUT ou PATCH na rota de uma tarefa específica, indicando o identificador dela.
- Apagar uma tarefa: DELETE na rota daquela tarefa.
Esse padrão de usar o mesmo endereço com métodos diferentes aparece em muitas APIs no estilo REST. Se o conceito de API ainda é novo para você, leia antes o que é API e para que serve.
GET ou POST em formulários
Em um formulário de busca, GET é comum porque os termos aparecem na URL e a página pode ser compartilhada ou salva. Em um formulário de login ou cadastro, usa-se POST: os dados vão no corpo da requisição e não ficam no endereço, no histórico nem em links copiados. Isso não substitui HTTPS: o POST sozinho não criptografa nada.
Códigos de resposta que acompanham
O servidor responde com um código de status. De forma geral:
- Os que começam com 2 indicam sucesso.
- Os que começam com 4 indicam problema na requisição, como rota inexistente ou falta de permissão.
- Os que começam com 5 indicam falha no servidor.
Veja detalhes em erro 404 e erro 500: o que significam.
Como praticar
Você pode testar métodos com a aba de rede das ferramentas do navegador, que mostra o método de cada requisição, ou com ferramentas de teste de API. Comece com GET em uma API pública, depois monte uma pequena API própria com POST e DELETE. Ao ver a requisição e a resposta lado a lado, os verbos deixam de ser abstratos.
