RUNWEBTOOLS
Português

Referência de métodos HTTP

Um método HTTP (ou “verbo”) diz ao servidor qual ação uma requisição quer realizar. As duas propriedades da tabela importam ao projetar APIs:

  • Seguro (Safe) — não muda o estado do servidor (somente leitura).
  • Idempotente — repetir a requisição tem o mesmo efeito que fazê-la uma vez.

Atualizado 2026-07-06

MétodoFinalidadeSeguroIdempotente
GETRecuperar um recurso; não deveria ter efeitos colateraisSimSim
HEADComo GET mas retorna só cabeçalhos, sem corpoSimSim
POSTCriar um recurso ou enviar dados para processamentoNãoNão
PUTSubstituir um recurso inteiramente pelo corpo da requisiçãoNãoSim
PATCHAplicar uma atualização parcial a um recursoNãoNão
DELETERemover um recursoNãoSim
OPTIONSPerguntar quais métodos/cabeçalhos são permitidos (preflight CORS)SimSim
CONNECTEstabelecer um túnel para o servidor (usado por proxies)NãoNão
TRACEEcoar a requisição recebida (diagnóstico; muitas vezes desativado)SimSim

Note a diferença entre PUT e PATCH: PUT substitui o recurso inteiro (então enviá-lo duas vezes é idempotente), enquanto PATCH aplica uma mudança parcial (que pode não ser). Combine isto com nossas referências de códigos de status e cabeçalhos para o panorama completo de uma requisição HTTP.

Ferramentas relacionadas