Os verbos HTTP são usados para definir ações específicas em recursos da web. Eles são uma parte fundamental do protocolo HTTP (HyperText Transfer Protocol) e são comumente usados em APIs RESTful. Aqui estão os principais verbos HTTP e suas funções:
Principais Verbos HTTP
GET:
Propósito: Recuperar dados de um servidor.
Exemplo: Obter uma lista de usuários ou detalhes de um único usuário.
Idempotência: Sim (várias requisições retornam o mesmo resultado).
Uso: GET /api/users
POST:
Propósito: Enviar dados para o servidor para criar um novo recurso.
Exemplo: Criar um novo usuário ou fazer login.
Idempotência: Não (cada requisição pode resultar em uma nova criação).
Uso: POST /api/users
PUT:
Propósito: Atualizar um recurso existente no servidor.
Exemplo: Atualizar informações de um usuário.
Idempotência: Sim (várias requisições resultam no mesmo estado).
Uso: PUT /api/users/{id}
DELETE:
Propósito: Remover um recurso do servidor.
Exemplo: Deletar um usuário.
Idempotência: Sim (várias requisições resultam no mesmo estado).
Uso: DELETE /api/users/{id}
PATCH:
Propósito: Atualizar parcialmente um recurso existente.
Exemplo: Atualizar parcialmente as informações de um usuário (apenas alguns campos).
Idempotência: Sim (várias requisições resultam no mesmo estado).
Uso: PATCH /api/users/{id}
HEAD:
Propósito: Recuperar os cabeçalhos de uma resposta sem o corpo.
Exemplo: Obter metadados sobre um recurso sem transferir o conteúdo.
Idempotência: Sim.
Uso: HEAD /api/users
OPTIONS:
Propósito: Obter informações sobre as opções de comunicação disponíveis para o recurso.
Exemplo: Descobrir quais métodos HTTP são suportados pelo servidor.
Idempotência: Sim.
Uso: OPTIONS /api/users
Tabela Resumida dos Verbos HTTP
Verbo | Propósito | Idempotência | Uso Exemplo |
GET | Recuperar dados | Sim | GET /api/users |
POST | Enviar dados para criar novo recurso | Não | POST /api/users |
PUT | Atualizar recurso existente | Sim | PUT /api/users/{id} |
DELETE | Remover recurso | Sim | DELETE /api/users/{id} |
PATCH | Atualização parcial de recurso existente | Sim | PATCH /api/users/{id} |
HEAD | Recuperar cabeçalhos | Sim | HEAD /api/users |
OPTIONS | Obter informações sobre comunicação | Sim | OPTIONS /api/users |
Conclusão
Os verbos HTTP são essenciais para a comunicação cliente-servidor em APIs RESTful. Cada verbo tem um propósito específico e comportamento que ajuda a definir como as ações devem ser realizadas nos recursos da web.