VERBOS HTTP

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.