Os métodos HTTP mais utilizados no desenvolvimento web são:
-
GET
Utilizado quando queremos obter informações de um recurso como uma lista de usuários, ou de um recurso com um ID específico por exemplo.
-
POST
Utilizado quando submetemos um objeto ao servidor, como criar um novo registro num banco de dados.
-
PUT
Utilizado para fazer a atualização completa de um objeto.
-
PATCH
Utilizado para fazer a atualização parcial de um objeto.
-
DELETE
Utilizado para fazer a remoção de um objeto da aplicação.
HTTP Codes
São códigos formados por três dígitos para indicar o status de uma resposta. Vamos ver alguns abaixo:
- 1xx: Informativo apenas, indica que uma solicitação foi feita ou o processo permanece em andamento
-
2xx: Confirmação
- 200 Ok: requisição bem sucedida, o retorno de uma requisição com o método GET por exemplo
- 201 Created: geralmente utilizado quando submetemos um novo objeto com o método POST
-
3xx: Redirecionamento
- 301 Moved Permanently: indica que o recurso solicitado foi movido permanentemente
-
4xx Erro no client
- 400 Bad Request: indica que o server não irá atender a requisição por algum erro na request como um erro de sintaxe por exemplo
- 401 Unauthorized: indica que a solicitação não foi atendida porque o client não tem as credenciais de autenticação válidas para o recurso
- 403 Forbidden: indica que o server entendeu a requisição mas não autorizou devido a uma senha incorreta por exemplo.
- 404 Not Found: indica que o server não encontrou o recurso solicitado, como uma rota inexistente.
-
5xx: Erro no server
- 500 Internal Server Error: indica que o server encontrou uma condição inesperada que o impediu de responder a requisição.
No desenvolvimento web podemos focar nos códigos 2xx, 4xx e 5xx que são os mais utilizados.
Parâmetros das requisições
-
Header Params
Parâmetros enviados no cabeçalho da requisição, como um token de autorização por exemplo.
-
Query Params
Parâmetros enviados no fim de uma URL após um ’?’, como um filtro de paginação. São parâmetros enviados como ‘chave=valor’ e separados por ’&‘. Ex.:
minhaapi.com.br/v1/products?page=2&limit10 -
Route Params
Parâmetros enviados no meio da rota. Por exemplo, se quero buscar um produto com um ID específico, então posso enviar da seguinte forma:
minhaapi.com.br/v1/products/15 -
Body Params
Parâmetros enviados no corpo da requisição