learnxinyminutes-docs/pt-br/httpie-pt.html.markdown

---
category: tool
tool: httpie
filename: learn-httpie-pt.sh
contributors:
  - ["Adaías Magdiel", "https://github.com/AdaiasMagdiel"]
translators:
  - ["Adaías Magdiel", "https://adaiasmagdiel.com/"]
lang: pt-br
---

HTTPie é um poderoso cliente HTTP para linha de comando, projetado para uma
integração suave com servidores HTTP. Oferece uma interface simples e intuitiva,
tornando-se uma excelente ferramenta para desenvolvedores, testadores e administradores de sistemas.

## Uso Básico

HTTPie possui uma sintaxe simples: http [flags] [MÉTODO] URL [itens].

```bash
http GET https://api.example.com/posts
```

Você pode exibir a requisição sem executá-la, de fato, usando a flag `--offline`.

```bash
http --offline https://api.example.com/posts
```

### Encurtando URLs `localhost`

HTTPie fornece suporte a atalhos para o localhost, similares aos do `curl`. Por exemplo, ":3000"
expande para "http://localhost:3000". Se a porta for omitida, o padrão será a porta 80.

```bash
http :/users    # http://localhost/users
http :5000/rss  # http://localhost:5000/rss
```

### Métodos Opcionais GET e POST

Se você não especificar o método, o HTTPie usará o seguinte:

- GET para requisições sem corpo
- POST para requisições com corpo

```bash
http https://api.example.com/tags # GET - Seleciona as tags
http https://api.example.com/tags title="Tutorial" slug="tutorial" # POST - Cria uma nova tag
```

## Parâmetros Querystring

Se você adiciona querystrings manualmente no terminal, tente a seguinte sintaxe:
`param==value`. Isso evita que o shell tente reconhecer o operador & como comando
e automaticamente escape caracteres especiais nos parâmetros.
Isso difere dos parâmetros na URL completa, que o HTTPie não modifica.

```bash
http https://api.example.com/search q==httpie per_page==20
```

## Enviando Dados

Você pode enviar dados nos mais diversos formatos, como JSON, formulários ou arquivos.

### JSON Data

```bash
http POST https://api.example.com/posts title="Hello" body="World"
```

### Form Data

```bash
http -f POST https://api.example.com/submit name=John email=john@example.com
```

### Files

```bash
http --form POST https://api.example.com/upload file@/path/to/file.txt
```

## Headers and Authentication

HTTPie allows you to set headers and handle authentication easily.

### Headers

```bash
http GET https://api.example.com/posts Authorization:"Bearer Token" User-Agent:"HTTPie"
```

### Basic Authentication

```bash
http -a username:password GET https://api.example.com/protected
```

### Bearer Authentication

```bash
https -A bearer -a token https://api.example.com/admin
```

## Response Handling

HTTPie provides various options for handling responses.

```bash
http GET https://api.example.com/data Accept:application/json  # Pretty Print JSON

http GET https://api.example.com/image --output image.png      # Save Response to File

http --follow GET https://example.com  # Follow Redirects
```

## Further Reading

- [Official Documentation](https://httpie.io/docs/cli).
- [Github](https://github.com/httpie).