Método HTTP

Definição

O método HTTP indica a semântica da operação solicitada em uma requisição. Ele diz ao servidor qual intenção o consumidor tem com aquele recurso, e o contrato da API traduz essa intenção em comportamento.

Consultar, criar, substituir, alterar e remover

GET consulta uma representação, POST cria um recurso, PUT substitui, PATCH altera parcialmente e DELETE remove. A família de cada verbo orienta a implementação e a leitura da operação.

GET /clientes HTTP/1.1

POST /clientes HTTP/1.1
Content-Type: application/json

{"nome":"Ana"}

O método expressa a intenção, não o comportamento

O método expressa a semântica pretendida, mas a implementação nem sempre cumpre o contrato. Um servidor pode responder a um GET com efeitos de escrita, contrariando o que a operação promete. Por isso a combinação de método, caminho e contrato define o comportamento esperado de cada operação.

Como conferir a operação executada

A falha mais comum é presumir o método correto sem confirmar o que a API implementou. Quando você envia GET e espera uma criação, ou chama DELETE no recurso errado, a resposta sai do contrato e o efeito pode não acontecer. Para conferir, abra a aba Network das ferramentas do navegador, selecione a chamada e veja o método junto do caminho e do status recebido. Comparar o trio com a documentação mostra se a operação executada é a que você pretendia, e um 405 indica que o método não pertence àquele endpoint.

Aplicação na formação

Vibe Coding: Do Zero ao MVP

Na Formação Vibe Coding, o método HTTP define qual operação a interface pretende executar em cada recurso da API.

Conhecer a formação →