Referência de métodos HTTP

• Busca instantânea em todos os métodos HTTP: nossa referência permite buscar por nome de método, descrição ou caso de uso em tempo real. Encontre exatamente o que precisa - seja regras de idempotência, códigos de status ou requisitos de corpo da requisição.
• Cartões expansíveis com semântica completa: cada cartão de método HTTP se expande para mostrar a semântica completa: propriedades seguro/idempotente/cacheável, casos de uso comuns, requisitos de corpo, códigos de status de sucesso e erro, e exemplos de requisições prontos para copiar.
• Referência de métodos HTTP online e segura: roda inteiramente no seu navegador - nenhum dado é enviado a servidor algum. Todos os dados de referência são carregados localmente, então a ferramenta funciona totalmente offline depois que a página carrega.
• Referência de métodos HTTP sem instalação e 100% grátis: use-a diretamente em qualquer navegador, sem downloads, conta e anúncios. Filtre por método, expanda todos os cartões de uma vez e copie exemplos de requisições - totalmente grátis para sempre.

• Design de API REST: use nossa referência de métodos HTTP para escolher o método correto ao projetar APIs REST. Entenda quando usar PUT em vez de PATCH, ou POST em vez de PUT, para construir endpoints semanticamente corretos e previsíveis.
• Integração e depuração de API: desenvolvedores que integram APIs de terceiros usam nossa referência para entender o que cada método faz e quais códigos de status esperar. Consulte rapidamente se um método é idempotente antes de repetir requisições que falharam.
• Desenvolvimento backend: engenheiros de backend usam nossa referência para implementar handlers de rota corretos. Entenda quais métodos exigem corpo de requisição, quais devem retornar 201 em vez de 200 e quais podem ser armazenados em cache.
• Desenvolvimento frontend e de cliente: desenvolvedores frontend usam nossa referência para escrever chamadas fetch e Axios corretas. Saiba quando usar POST para envio de formulários, GET para buscar dados e DELETE para remover recursos.
• Redação de documentação de API: redatores técnicos usam nossa referência para documentar APIs com precisão. Consulte a semântica, as regras de idempotência e os códigos de status corretos de cada método na sua documentação OpenAPI ou Swagger.
• Aprendizado e preparação para entrevistas: desenvolvedores que aprendem REST ou preparam entrevistas técnicas usam nossa referência para dominar a semântica HTTP. Entenda métodos seguros vs idempotentes, o preflight CORS e a diferença entre PUT e PATCH.

Os métodos HTTP (também chamados de verbos HTTP) definem a ação a executar em um recurso identificado por uma URL. Eles são parte central do protocolo HTTP e a base do design de APIs RESTful. Os métodos mais usados são GET (obter), POST (criar), PUT (substituir), PATCH (atualização parcial) e DELETE (remover). Outros métodos como HEAD , OPTIONS , CONNECT e TRACE têm propósitos especializados. Nossa referência de métodos HTTP cobre todos os métodos padrão com sua semântica, casos de uso e detalhes de requisição e resposta.

1. Explore ou busque: use a barra de busca para encontrar qualquer método HTTP por nome, descrição ou caso de uso. Ou clique em uma pílula de filtro (GET, POST, PUT etc.) para ir direto a esse método. Todo o filtro roda na hora no seu navegador.
2. Expanda para ver todos os detalhes: clique em qualquer cartão de método para expandi-lo e ver a referência completa - propriedades seguro/idempotente/cacheável, casos de uso, requisitos de corpo, códigos de status de sucesso e erro, e exemplos de requisições HTTP. Use «Expandir tudo» para abrir todos os métodos de uma vez.
3. Copie exemplos de requisições: cada método inclui exemplos de requisições HTTP prontos para copiar. Clique no botão Copiar de qualquer exemplo para copiá-lo para a área de transferência e usá-lo no seu cliente de API, documentação ou código.

• Seguro: um método é seguro se não modifica o estado do servidor. GET, HEAD e OPTIONS são seguros - apenas recuperam informação. POST, PUT, PATCH e DELETE não são seguros porque alteram dados no servidor.
• Idempotente: um método é idempotente se repetir a mesma requisição várias vezes produz o mesmo resultado que fazê-la uma vez. GET, HEAD, OPTIONS, PUT e DELETE são idempotentes. POST não é - enviar o mesmo POST duas vezes geralmente cria dois recursos.
• Cacheável: um método é cacheável se suas respostas podem ser armazenadas e reutilizadas. As respostas de GET e HEAD são cacheáveis por padrão. As de POST só são cacheáveis com cabeçalhos Cache-Control explícitos. As de PUT, PATCH e DELETE não são cacheáveis.
• Corpo da requisição: alguns métodos carregam corpo de requisição (POST, PUT, PATCH) e outros não (GET, HEAD, DELETE, OPTIONS). Enviar corpo com GET é tecnicamente permitido, mas fortemente desencorajado e frequentemente ignorado pelos servidores.

PUT substitui o recurso inteiro - você precisa enviar todos os campos, e qualquer campo não incluído será definido como null ou seu valor padrão. Use PUT quando quiser substituir completamente um recurso. PATCH aplica uma atualização parcial - só os campos que você envia são alterados e todos os outros permanecem iguais. Use PATCH quando precisar atualizar apenas um ou poucos campos. Na prática, a maioria das APIs REST modernas prefere PATCH para atualizações, porque é mais eficiente e menos propenso a erros do que enviar o recurso inteiro a cada atualização.