Converter curl para HTTPie

O HTTPie é um cliente HTTP de linha de comando amigável, concebido para testar e depurar APIs. Apresenta saída colorida, suporte para JSON por predefinição, sintaxe expressiva e sessões persistentes. Instale com pip install httpie ou brew install httpie. O curl2code converte comandos curl para a sintaxe mais legível do HTTPie.

O HTTPie é o mais legível — ideal para testes de API e utilização interativa. O curl é o mais rico em funcionalidades e universal — disponível em todos os sistemas. O Wget especializa-se em descarregar ficheiros e espelhar sites. Utilize o HTTPie para o trabalho diário com APIs, e o curl para scripts e automação. Veja também curl para Wget.

O HTTPie tem autenticação integrada: http -a user:pass GET url para autenticação Basic. Para Bearer: http GET url 'Authorization:Bearer token'. Plugins de autenticação suportam OAuth, JWT e mais. A autenticação do HTTPie é mais simples do que as flags -u e -H do curl — uma das suas principais vantagens de usabilidade.

Utilize a flag -f para dados de formulário: http -f POST url field=value file@path.pdf. O HTTPie deteta automaticamente o tipo de conteúdo. Para JSON (o padrão): http POST url name=John age:=30. O operador := envia valores JSON em bruto. Isto é muito mais intuitivo do que as flags -F e -d do curl.

O HTTPie mostra o estado e o corpo da resposta coloridos por predefinição. Utilize --check-status para sair com códigos de erro em caso de erros HTTP (código de saída 4 para 4xx, 5 para 5xx). Utilize --print=hHbB para controlar a saída: cabeçalhos e corpo do pedido/resposta. Encaminhe para o jq para análise de erros JSON.

JSON é o padrão do HTTPie — define automaticamente Content-Type: application/json e formata visualmente (pretty-print) as respostas JSON com realce de sintaxe. Utilize = para valores de string, := para JSON em bruto, :=@ para JSON a partir de ficheiro. Esta é a maior vantagem do HTTPie sobre a abordagem manual -H e -d do curl.

Utilize --verbose (ou -v) para mostrar o pedido e a resposta completos, incluindo cabeçalhos. Utilize --offline para pré-visualizar o pedido sem o enviar. Utilize --session=name para cookies e cabeçalhos persistentes entre chamadas. A saída colorida do HTTPie torna a depuração significativamente mais legível do que o -v do curl.

Plugins populares: httpie-oauth para OAuth, httpie-jwt-auth para JWT, httpie-aws-auth para AWS Signature V4, httpie-edgegrid para Akamai. Instale com pip install httpie-plugin-name. O HTTPie também suporta ~/.httpie/config.json para cabeçalhos e definições predefinidas.

Utilize o -X POST -d '{"key":"value"}' -H "Content-Type: application/json" do curl e o curl2code irá convertê-lo para o formato HTTPie: http POST url key=value. O corpo JSON e o cabeçalho Content-Type são preservados no resultado. O curl2code lida tanto com JSON inline como com referências @file.json.

Quando converte curl -H "Authorization: Bearer YOUR_TOKEN" URL com o curl2code, o token Bearer é preservado no resultado HTTPie: http url Authorization:'Bearer YOUR_TOKEN'. Tanto as flags -H "Authorization: Bearer ..." como as flags de token OAuth são detetadas automaticamente.

Ao converter curl -H "Content-Type: application/json" URL, o curl2code apresenta o Content-Type em HTTPie como: http --json url. Os tipos comuns incluem application/json, application/x-www-form-urlencoded e multipart/form-data. O curl2code preserva o Content-Type exato do comando curl original.