Olá, pessoal! Neste post, você vai aprender uma dica prática para quem usa cURL no dia a dia.
Se você já tentou executar um comando curl com URL muito longa, muitos headers e payload grande, pode ter recebido erro como Argument list too long ou percebido que o terminal cortou parte do comando.
Isso acontece porque o shell do sistema operacional tem limite de tamanho para argumentos passados na linha de comando.
A solução: arquivo de configuração (-K)
O cURL possui a opção -K (ou --config), que permite ler os argumentos a partir de um arquivo de texto, em vez de enviar tudo diretamente na linha de comando.
Como usar
Crie um arquivo, por exemplo curl-config.txt, e adicione os parâmetros da requisição. Você pode informar URL, cabeçalhos, dados e outras opções suportadas pelo cURL.
Exemplo de arquivo curl-config.txt:
url = "https://api.exemplo.com/v1/transacoes?filtro=complexo&data_inicio=2024-01-01&data_fim=2024-12-31"
header = "Content-Type: application/json"
header = "Authorization: Bearer SEU_TOKEN_GIGANTE_QUE_ESTOURA_O_LIMITE_DO_TERMINAL..."
data = "{\"usuario\": \"teste\", \"detalhes\": \"payload muito grande...\"}"
verbose
A sintaxe básica é opção = valor para parâmetros com valor e apenas opção para flags (como verbose e insecure).
Para executar a requisição:
curl -K curl-config.txt
Ou, na versão longa:
curl --config curl-config.txt
Vantagens
- Menos risco de estourar limite de terminal: reduz erros por comandos longos.
- Mais organização: fica mais fácil manter e versionar chamadas complexas.
- Mais segurança: evita expor tokens e dados sensíveis no histórico de comandos.
Conclusão
Essa funcionalidade nativa do cURL ajuda bastante em cenários de debug, integração e automação de chamadas HTTP mais complexas.
Se você lida com APIs no dia a dia, vale a pena adotar esse padrão.
Referências
cURL. Documentation: --config. Disponível em: https://curl.se/docs/manpage.html#-K. Acesso em: 14 fev. 2026.
