1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
|
---
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.
### Enviando JSON
```bash
http POST https://api.example.com/posts title="Olá" body="Mundo"
```
### Enviando Formulário
```bash
http -f POST https://api.example.com/submit name=John email=john@example.com
```
### Enviando Arquivos
```bash
http --form POST https://api.example.com/upload file@/caminho/do/arquivo.txt
```
## Headers e Autenticação
HTTPie permite que você adicione headers e lide com autenticação de uma forma fácil.
### Headers
```bash
http GET https://api.example.com/posts Authorization:"Bearer Token" User-Agent:"HTTPie"
```
### Autenticação Básica
```bash
http -a usuario:senha GET https://api.example.com/protected
```
### Autenticação Bearer
```bash
https -A bearer -a token https://api.example.com/admin
```
## Lidando com Respostas
HTTPie fornece várias opções para lidar com respostas.
```bash
http GET https://api.example.com/data Accept:application/json # Exibe o JSON de uma forma legível
http GET https://api.example.com/image --output image.png # Grava a resposta em um arquivo
http --follow GET https://example.com # Segue redirecionamentos
```
## Leitura Adicional
- [Documentação Oficial](https://httpie.io/docs/cli)
- [GitHub](https://github.com/httpie)
|
