Referência de Métodos HTTP
Desenvolvimento
As quatro propriedades que realmente moldam design de API — safe (sem efeitos colaterais server-side), idempotente (mesmo estado final em N repetições), cacheable (response reutilizável), e body-bearing (request e response) — coletadas por método, com resumo de uma linha de quando cada um é apropriado.
Retrieve a representation of a resource. Should have no side effects.
- Safe
- Sim
- Idempotente
- Sim
- Cacheable
- Sim
- Req body
- Não
- Res body
- Sim
Like GET but with no response body. Used to inspect headers (size, ETag, Last-Modified).
- Safe
- Sim
- Idempotente
- Sim
- Cacheable
- Sim
- Req body
- Não
- Res body
- Não
Submit data to the server — create a new resource, send a form, or trigger a side-effecting action. Cacheable only when explicit Cache-Control / Expires headers permit.
- Safe
- Não
- Idempotente
- Não
- Cacheable
- Talvez
- Req body
- Sim
- Res body
- Sim
Replace the target resource entirely with the request payload. Calling it twice gives the same result as once.
- Safe
- Não
- Idempotente
- Sim
- Cacheable
- Não
- Req body
- Sim
- Res body
- Sim
Remove the target resource. Idempotent in the same sense as PUT — deleting an already-gone resource still ends with the same state.
- Safe
- Não
- Idempotente
- Sim
- Cacheable
- Não
- Req body
- Talvez
- Res body
- Sim
Apply a partial update to the resource. RFC 5789 leaves the patch format up to the API — JSON Patch (RFC 6902) and JSON Merge Patch (RFC 7396) are the common choices.
- Safe
- Não
- Idempotente
- Não
- Cacheable
- Não
- Req body
- Sim
- Res body
- Sim
Ask what the server supports for the target — methods, CORS preflight, accepted Content-Types. The response usually carries an Allow header.
- Safe
- Sim
- Idempotente
- Sim
- Cacheable
- Não
- Req body
- Não
- Res body
- Sim
Echo back the request as the server sees it after proxies. Usually disabled in production for security (Cross-Site Tracing).
- Safe
- Sim
- Idempotente
- Sim
- Cacheable
- Não
- Req body
- Não
- Res body
- Sim
Establish a tunnel to the server, used by HTTP proxies for HTTPS. The client and server exchange raw bytes after the proxy accepts.
- Safe
- Não
- Idempotente
- Não
- Cacheable
- Não
- Req body
- Não
- Res body
- Não
"Talvez" significa que a propriedade só vale com headers explícitos (Cache-Control em POST, body em DELETE).
Como usar
- Digite um nome de método (`patch`) ou palavra-chave (`cache`, `tunnel`) pra filtrar.
- Leia o cartão por método: descrição em cima, os cinco pontos de propriedades embaixo.
- Clique copiar pra colocar o método na sua chamada fetch ou comando curl.
Perguntas frequentes
- Por que PATCH tem método próprio se POST poderia fazer o mesmo?
- Semântica. PATCH significa "aplique esse diff parcial"; POST é "crie ou processe esse payload". Chamar PATCH duas vezes deveria deixar o recurso igual a chamá-lo uma se seu formato de patch é bem desenhado; essa garantia de idempotência vale o verbo extra.
- POST realmente é cacheable?
- Condicionalmente — RFC 9111 §3 permite cachear responses POST quando a resposta carrega headers explícitos `Cache-Control` / `Expires`. Na prática quase ninguém faz isso, então maioria dos caches trata POST como não cacheable.
Ferramentas relacionadas
Decodificador JWT
Decodifique um JSON Web Token para inspecionar cabeçalho, claims e expiração.
Gerador de UUID
Gere UUIDs v4 aleatórios em lote, com cópia.
Gerador de Hash (SHA)
Gere hashes SHA-1, SHA-256, SHA-384 e SHA-512 a partir de texto.
Codificador / Decodificador de URL
Codifique texto para URLs em porcentagem, ou decodifique URLs em texto.
Codificador / Decodificador Base64
Codifique texto em Base64 ou decodifique Base64 de volta em texto.
Formatador e Validador de JSON
Formate, embeleze, minifique e valide JSON no seu navegador.