# Como Enviar Headers HTTP com cURL: Um Guia Completo com Exemplos

Domine o envio e o recebimento de cabeçalhos HTTP usando cURL com este guia completo. Explore exemplos, cabeçalhos personalizados e dicas para solução de problemas.

- Autor: [Brandon Perry](https://fineproxy.org/pt/brandon-perry/)
- Publicado: 2023-09-21T04:37:23.000Z
- Atualizado: 2025-05-28T07:10:00.000Z
- URL canônica: https://fineproxy.org/pt/how-to-send-http-headers-with-curl-a-comprehensive-guide-with-examples/

Enviar cabeçalhos HTTP com cURL é uma habilidade fundamental para quem trabalha com APIs ou serviços web. Os cabeçalhos HTTP transmitem informações essenciais sobre sua solicitação, como tipo de conteúdo, autorização e muito mais. cURL, uma poderosa ferramenta de linha de comando para fazer solicitações HTTP, permite personalizar e enviar esses cabeçalhos sem esforço. Neste guia, orientaremos você no processo de envio de cabeçalhos HTTP usando cURL, completo com uma variedade de exemplos práticos.

![Como Enviar Headers HTTP com cURL: Um Guia Completo com Exemplos](/wp-content/uploads/2023/09/Depositphotos_4352211_XL-2048x1448.jpg)

## Pré-requisitos

Antes de prosseguirmos com exemplos, certifique-se de que o cURL está instalado no seu sistema. Você pode verificar se está instalado executando:

```
curl --version
```

Se não estiver instalado, você pode baixá-lo no site oficial do cURL.

## Sintaxe Básica do cURL

A sintaxe básica para enviar uma requisição HTTP com cURL é:

```
curl [options] [URL]
```

Para incluir headers HTTP na sua requisição, você pode usar a opção -H ou –header seguida pelas informações do header.

### Exemplo 1: Enviando uma Requisição GET com Headers Personalizados

Vamos começar com uma solicitação GET simples para uma API hipotética, incluindo um cabeçalho personalizado. Suponha que você queira incluir um cabeçalho “Autorização” com sua chave de API.

```
curl -H "Authorization: Bearer YOUR_API_KEY" https://api.example.com/resource
```

Substitua YOUR\_API\_KEY pela sua chave de API real.

### Exemplo 2: Enviando uma Requisição POST com Dados JSON

Neste exemplo, enviaremos uma solicitação POST com uma carga JSON e um cabeçalho de tipo de conteúdo personalizado.

```
curl -X POST -H "Content-Type: application/json" -d '{"name": "John", "email": "[email protected]"}' https://api.example.com/users
```

Este comando especifica o método de solicitação como POST (-X POST), define o tipo de conteúdo como JSON (-H “Content-Type: application/json”) e inclui os dados JSON com -d.

### Exemplo 3: Definindo Múltiplos Headers

Você pode incluir múltiplos cabeçalhos em uma única solicitação cURL. Aqui, estamos enviando uma requisição com os cabeçalhos „Authorization

```
curl -H "Authorization: Bearer YOUR_API_KEY" -H "User-Agent: MyClient/1.0" https://api.example.com/resource
```

### Exemplo 4: Envio de Cookies

Para enviar cookies com sua solicitação, use a opção -b ou –cookie seguida pelos dados do cookie.

```
curl -b "session=12345; preferences=darkmode" https://api.example.com/dashboard
```

Este exemplo envia dois cookies: “sessão” e “preferências”.

### Exemplo 5: Seguindo Redirecionamentos

Por padrão, cURL não segue redirecionamentos HTTP. Para ativar o seguimento de redirecionamentos, use a opção -L ou –location.

```
curl -L https://example.com
```

Este comando seguirá qualquer redirecionamento e exibirá o conteúdo final da página.

### Exemplo 6: Enviando User-Agent Personalizado

Você pode definir um cabeçalho User-Agent personalizado para identificar sua solicitação.

```
curl -H "User-Agent: MyCustomApp/1.0" https://api.example.com/resource
```

Cabeçalhos User-Agent personalizados são úteis ao interagir com APIs que exigem agentes de usuário específicos.

### Exemplo 7: Envio de cabeçalhos de solicitação sem dados

Se precisar enviar um cabeçalho sem corpo de solicitação, você pode usar a opção -I ou –head.

```
curl -I https://api.example.com/resource
```

Este comando envia uma solicitação HEAD, que busca apenas os cabeçalhos e não o conteúdo real.

### Exemplo 8: Envio de autenticação básica

Para enviar credenciais de autenticação básica HTTP, você pode incluir um cabeçalho “Autorização” com seu nome de usuário e senha codificados em Base64.

```
curl -H "Authorization: Basic BASE64_ENCODED_CREDENTIALS" https://api.example.com/resource
```

Substitua BASE64\_ENCODED\_CREDENTIALS pelas suas credenciais codificadas em Base64 (por exemplo, username:password).

### Exemplo 9: Depuração e modo detalhado

Ao solucionar problemas ou inspecionar a solicitação e resposta HTTP, você pode usar o modo verbose do cURL com a opção -v ou –verbose.

```
curl -v https://api.example.com/resource
```

Isto exibirá informações detalhadas sobre a solicitação e resposta, incluindo cabeçalhos.

Enviar cabeçalhos HTTP com cURL é uma habilidade crucial para trabalhar com serviços web e APIs. Com os exemplos fornecidos neste guia, você pode personalizar suas solicitações, lidar com autenticação, enviar cookies e muito mais. Conforme você se familiarizar com as capacidades do cURL, estará bem preparado para interagir com vários serviços web efetivamente.

![Como Enviar Headers HTTP com cURL: Um Guia Completo com Exemplos](/wp-content/uploads/2023/09/Depositphotos_119316288_XL-2048x1239.jpg)