Skip to main content

Protocolo HTTP | Redes

  • Protocolo HTTP | Redes

info

Protocolo HTTP é um protocolo bloqueante e não é assíncrono


Verbos HTTP

1. GET

  • Uso: Recuperar dados de um servidor.
  • Quando usar: Quando você quer obter informações de um recurso específico ou uma lista de recursos.
  • Exemplo: GET /usuarios (obtém a lista de usuários), GET /usuarios/{id} (obtém os detalhes de um usuário específico).

2. POST

  • Uso: Enviar dados ao servidor para criar um novo recurso.
  • Quando usar: Quando você quer adicionar um novo recurso ao servidor.
  • Exemplo: POST /usuarios (cria um novo usuário).

3. PUT

  • Uso: Atualizar completamente um recurso existente no servidor.
  • Quando usar: Quando você quer substituir completamente os dados de um recurso existente.
  • Exemplo: PUT /usuarios/{id} (atualiza todos os dados de um usuário específico).

4. PATCH

  • Uso: Atualizar parcialmente um recurso existente no servidor.
  • Quando usar: Quando você quer modificar apenas algumas partes de um recurso existente.
  • Exemplo: PATCH /usuarios/{id} (atualiza alguns dados de um usuário específico).

5. DELETE

  • Uso: Excluir um recurso existente no servidor.
  • Quando usar: Quando você quer remover um recurso do servidor.
  • Exemplo: DELETE /usuarios/{id} (remove um usuário específico).

6. OPTIONS

  • Uso: Descrever as opções de comunicação para o recurso de destino.
  • Quando usar: Quando você quer descobrir os métodos HTTP suportados por um recurso específico.
  • Exemplo: OPTIONS /usuarios (informa os métodos suportados pela rota /usuarios).

7. HEAD

  • Uso: Recuperar os cabeçalhos de resposta, sem o corpo da resposta.
  • Quando usar: Quando você quer verificar se um recurso existe ou obter metadados do recurso sem transferir todo o conteúdo.
  • Exemplo: HEAD /usuarios/{id} (verifica a existência e obtém os cabeçalhos de um usuário específico).

Exemplo prático:

Para uma API de gerenciamento de usuários, as rotas e verbos HTTP poderiam ser organizados assim:

  • GET /usuarios - Recuperar a lista de usuários.
  • GET /usuarios/{id} - Recuperar detalhes de um usuário específico.
  • POST /usuarios - Criar um novo usuário.
  • PUT /usuarios/{id} - Atualizar completamente os dados de um usuário específico.
  • PATCH /usuarios/{id} - Atualizar parcialmente os dados de um usuário específico.
  • DELETE /usuarios/{id} - Remover um usuário específico.

Usando esses verbos HTTP corretamente, você segue as práticas recomendadas de design de APIs RESTful, garantindo clareza e consistência na comunicação entre o cliente e o servidor.

Resumo dos métodos

alt text