Principais métodos HTTP: um guia rápido

O protocolo HTTP, grande amigo de desenvolvedores backend, define os métodos de requisição responsáveis por executar os recursos de nossas APIs. Cada método HTTP possui sua respectiva funcionalidade e modo de uso, e os mais utilizados são GET, POST, PUT e DELETE.

Quando começamos a estudar sobre APIs, pode surgir a dúvida de qual método HTTP utilizar em determinadas situações. Por isso, descrevo abaixo, de maneira breve, o uso dos principais métodos HTTP.

1. GET (READ)

Utilizado para ler ou recuperar uma representação de um recurso. Em um cenário de sucesso, retorna uma representação em XML ou JSON e um HTTP status code 200 (OK). Em um cenário de erro, comumente retorna 404 (NOT FOUND) ou 400 (BAD REQUEST).

Parâmetros suportados:

• Via URL (Path ou Query Params)
• Via header

2. POST (CREATE)

Utilizado para criar novos recursos. Em caso de sucesso, retorna o status code 200 (OK) ou 201 (CREATED).

Parâmetros suportados:

• Via URL (Path ou Query Params)
• Via header
• Via body (recomendado)

3. PUT (UPDATE)

Utilizado para modificar um recurso, colocando um recurso conhecido no body da requisição contendo novas informações que representam o recurso original. Em casos bem sucedidos, retorna um status code 200 (OK), ou 204 (NO CONTENT) — quando não há nenhum conteúdo no body da resposta.

Parâmetros suportados:

• Via URL (Path ou Query Params)
• Via header
• Via body (recomendado)

4. DELETE (DELETE)

Utilizado para remover um recurso identificado por uma URI. Em uma deleção bem sucedida, retorna o status code 200 (OK) juntamente com um response body com uma representação do item deletado ou uma response customizada. O mais recomendado, entretanto, é não retornar nada com um status code 204 (NO CONTENT), sem response body, ou um JSEND-style response com status code 200.

Parâmetros suportados:

• Via URL (Path — recomendado — ou Query Params)
• Via header
• Via body

Bons estudos! 💻🤓