Referência técnica e guia de arquitetura

Guia de cURL para Python Requests, httpx e aiohttp — Guia de referência

Converta comandos cURL em código Python idiomático utilizando requests, httpx assíncrono e aiohttp. Sanitização de cabeçalhos e privacidade total no navegador.

Parâmetros principais e controles

rawCurlstring

Comando cURL bruto do terminal ou DevTools.

Padrão: Auto
wrapInFunctionboolean

Envolve a requisição em uma função ou corrotina async def.

Padrão: true
cleanDevToolsboolean

Remove pseudocabeçalhos do navegador (:authority) que quebram o Python.

Padrão: true
jsonAsDictboolean

Converte JSON para dicionário nativo Python para o argumento json=.

Padrão: true

Dicas profissionais e melhores práticas

Sanitização de pseudocabeçalhos (:authority)

Cabeçalhos iniciados por dois pontos (:) causam erros de InvalidHeader no Python. Mantenha a limpeza de DevTools ativada.

Prefira o parâmetro json= ao invés de data=json.dumps()

Ao passar json=payload, o requests define o Content-Type: application/json e cuida da codificação UTF-8.

Utilize requests.Session() para reuso de conexões

Em chamadas recorrentes, uma Session economiza tempo de handshake TCP e mantém o estado de cookies.

Problemas comuns e solução de problemas

Erro InvalidHeader: Invalid leading colon

Ative a opção 'Remover pseudocabeçalhos do DevTools' para purgar :authority dos cabeçalhos.

Código de resposta HTTP 415 Unsupported Media Type

Use o argumento json=payload em vez de data= e confira se o cabeçalho JSON está configurado.

Perguntas frequentes (FAQ)

Quando usar httpx no lugar de requests?▼

Utilize httpx para arquiteturas assíncronas com FastAPI e asyncio ou quando precisar de suporte nativo a HTTP/2.

Como os valores booleanos e nulos do JSON são convertidos?▼

true vira True, false vira False e null é convertido para None.

Como envios de arquivos (-F file=@path) são mapeados?▼

São mapeados para o dicionário files={'file': open('path', 'rb')} com multipart boundary automático.

Existe envio de tokens para servidores externos?▼

Não. Todo o processo é executado no ambiente seguro do seu navegador.

Ferramentas e utilitários relacionados

Todas as ferramentas →