O que é o método POST em HTTP?

O método POST é utilizado para enviar dados ao servidor para criar ou atualizar um recurso. Os dados são transmitidos no corpo da requisição.

Características principais:

• Segurança: Os dados não aparecem na URL, tornando-o preferível para enviar informações confidenciais.
• Idempotência: Geralmente, as requisições POST não são idempotentes. Repetir a mesma requisição POST pode levar à criação de múltiplos recursos ou outros efeitos colaterais.
• Caching: Requisições POST, geralmente, não são cacheadas.
• Transmissão de dados: Os dados são enviados no corpo da requisição, permitindo enviar grandes volumes de dados.

Exemplos de uso:

• Envio de dados de formulários (registo, autenticação).
• Upload de ficheiros para o servidor.
• Criação de um novo objeto na base de dados via API.

Comparação com o método GET:

Característica	POST	GET
Transmissão de dados	No corpo da requisição	Na URL (parâmetros de consulta)
Visibilidade dos dados	Os dados não são visíveis na URL	Os dados são visíveis na URL
Segurança	Adequado para dados confidenciais	Não adequado para dados confidenciais
Idempotência	Geralmente, não é idempotente	É idempotente
Caching	Não é cacheado	É cacheado
Volume de dados	Sem restrições de volume (depende do servidor)	Limitado pelo comprimento da URL
Propósito	Criação/atualização de recursos	Obtenção de recursos

Exemplo de requisição HTTP com método POST:

POST /users HTTP/1.1
Host: example.com
Content-Type: application/json

{
    "username": "john_doe",
    "email": "john.doe@example.com"
}