terminal Gerador de Comando curl star

Uma Breve História do curl

O curl foi criado em 1998 pelo desenvolvedor sueco Daniel Stenberg, que escreveu a sua primeira versão para obter automaticamente taxas de câmbio para um bot de IRC num canal de chat sueco — uma necessidade pequena e pessoal, não um grande plano para construir infraestrutura. As pessoas continuaram a pedir mais protocolos e mais opções, e essa pequena ferramenta transformou-se numa ferramenta de linha de comando de uso geral para transferir dados via HTTP, HTTPS, FTP e, com o tempo, dezenas de outros protocolos. Stenberg permaneceu como mantenedor principal do curl praticamente durante toda a sua existência; hoje o curl vem pré-instalado por padrão no macOS, em praticamente todas as distribuições Linux e — desde 2018 — no Windows 10 e versões posteriores, estimando-se que seja executado em milhares de milhões de dispositivos em todo o mundo, de routers e automóveis a consolas de jogos e em quase todos os pipelines de integração contínua que comunicam com uma API. O que começou como a solução para um problema pessoal muito específico é hoje, sem exagero, o cliente HTTP de linha de comando mais amplamente utilizado que existe, e uma das peças de software open-source de que a internet mais depende silenciosamente.

Como Interpretar as Flags Que Esta Ferramenta Gera

Por padrão, o curl não segue redirecionamentos HTTP. Se um servidor responder com um código de estado 301 ou 302 e um cabeçalho Location a apontar para outro lugar, o curl simples mostra essa resposta de redirecionamento — ou um corpo vazio — e para; não segue automaticamente o novo URL da forma silenciosa como um navegador o faz. Isto confunde um número enorme de utilizadores que usam o curl pela primeira vez: um URL que funciona perfeitamente num navegador devolve uma resposta confusa, vazia ou incorreta no curl, aparentemente sem motivo, simplesmente porque o navegador seguiu um redirecionamento que o curl não seguiu. A solução é a flag -L (--location), que diz ao curl para seguir a cadeia de redirecionamentos até ao destino final. É uma necessidade tão comum que muitos engenheiros usam -L por padrão sempre que não estão deliberadamente a testar o comportamento de redirecionamento em si.

Assim que um comando inclui cabeçalhos ou conteúdo no corpo com espaços, aspas ou caracteres especiais da shell ($, &, ;, crases), a forma como se coloca entre aspas deixa de ser cosmética — passa a ser a diferença entre um pedido que funciona e um que a shell corrompe antes mesmo de o curl o receber. Um cabeçalho como Authorization: Bearer abc 123 escrito sem aspas é dividido pela shell no espaço, pelo que o curl recebe Authorization: e Bearer como dois argumentos separados e quebrados, em vez de um só. Colocar todo o valor entre aspas simples diz à shell para tratar tudo o que está dentro literalmente, incluindo espaços — mas as aspas simples não podem conter um carácter de aspa simples literal, uma vez que é precisamente esse carácter que fecha a aspa. O escape padrão para esse caso é fechar a aspa, inserir uma aspa simples precedida de barra invertida e reabrir a aspa: '\''. Esta ferramenta aplica esse escape automaticamente a cada valor que insere, pelo que cabeçalhos, conteúdo do corpo e credenciais de autenticação com espaços, aspas ou outros caracteres especiais produzem sempre um comando que funciona corretamente — sem que precise de decorar as regras de escape.