9 de 9
vs
Segurança diferenteIdempotência diferente
- GET is safe, POST is not safe.
- GET is idempotent, POST is not idempotent.
- GET does not take a body, POST takes a body.
O que faz
A referência de métodos HTTP é uma tabela de consulta rápida para os nove métodos de pedido HTTP (RFC 9110). Para cada método mostra as quatro propriedades que mais importam no desenho de APIs — safe, idempotent, cacheable e recebe body — mais uma descrição em linguagem clara e o seu uso típico. Pesquise, filtre por propriedade, clique num método para a entrada completa e compare quaisquer dois métodos para ver exatamente onde a sua semântica difere.
Como usar
- Pesquise por nome de método ou significado (p. ex.
patch,partial). - Alterne os filtros Safe / Idempotent / Cacheable para estreitar a lista.
- Clique num método para ler a descrição completa e os casos de uso típicos.
- Use Compare two methods (p. ex. PUT vs PATCH) para ver as diferenças semânticas.
Exemplos
GET
Safe, idempotent, cacheable; retrieves a resource without changing it.PUT vs. PATCH
Both modify a resource, but only PUT is idempotent (PATCH can have different effects when repeated).POST vs. PUT
POST creates under a collection (server picks the URL, not idempotent); PUT puts a resource at a known URL (idempotent).Bom saber
- Safe vs. idempotent: safe significa «sem alteração de estado no servidor»; idempotent significa «repetir a chamada tem o mesmo efeito que uma». Todos os métodos safe são idempotent, mas não o inverso (PUT e DELETE são idempotent mas não safe).
- Fonte: as bandeiras de propriedades seguem a RFC 9110 / RFC 9111 e a referência MDN.
POSTé marcado como cacheable pela especificação, embora as caches raramente armazenem respostas POST sem diretivas explícitas. - Ferramentas relacionadas: HTTP Status Codes, JSON Formatter, URL Encoder.