De cURL para código

O que faz o De cURL para código

O De cURL para código analisa um comando curl e reescreve-o como código executável em dois ecossistemas: uma chamada fetch para o navegador ou Node.js e uma chamada requests de Python. Divide o comando em tokens como o faria uma shell, respeitando aspas simples e duplas e continuações de linha, e depois extrai o método do pedido, o URL de destino, os cabeçalhos e o corpo. O método predefinido é GET, muda automaticamente para POST quando existe corpo e respeita uma opção explícita -X ou --request. Os cabeçalhos de cada opção -H ou --header são reunidos num objeto, e a autenticação básica indicada com -u é convertida num cabeçalho Authorization.

Os dados do corpo de -d, --data, --data-raw e --data-binary são preservados tal como estão e anexados a ambos os excertos. Isto é útil quando copia um pedido como cURL do painel de rede do navegador ou da documentação de uma API e quer um ponto de partida no código da aplicação em vez de um comando de shell. Gerar as duas linguagens em simultâneo facilita partilhar um exemplo com colegas que trabalham com outras tecnologias, ou transformar um teste manual rápido num cliente automatizado.

Fluxo de trabalho privado no navegador

Toda a tokenização e geração de código acontecem no seu navegador com JavaScript do lado do cliente. A ferramenta não envia para nenhum servidor o seu comando curl, URLs, cabeçalhos, tokens ou corpos de pedido e não exige conta. Este modelo exclusivamente local é importante porque um comando curl copiado contém muitas vezes cabeçalhos de autorização, cookies e chaves de API capturados de uma sessão real. Manter a conversão no seu computador significa que esses segredos nunca saem da página e que os excertos aparecem instantaneamente, sem pedidos de rede.

A interface mostra o comando original junto dos dois excertos gerados, para que possa verificar o método, o URL, os cabeçalhos e o corpo antes de copiar. Reveja o resultado antes de o executar: remova ou renove quaisquer credenciais incorporadas no comando e confirme que o URL de destino é o ambiente que pretende chamar.

Dicas práticas

Para obter os melhores resultados, cole um único comando curl em vez de uma cadeia de comandos de shell e mantenha as continuações de linha intactas para que as opções não sejam fundidas. Quando o corpo é JSON, o excerto fetch gerado envia-o como cadeia de texto, tal como o curl; analise-o e volte a serializá-lo no seu código se preferir construir o objeto de forma programática. O excerto Python usa o argumento data para refletir o corpo em bruto; mude para o argumento json quando quiser que o requests defina o tipo de conteúdo e serialize um objeto por si. Trate sempre os clientes gerados como um rascunho e acrescente tratamento de erros, tempos limite e novas tentativas adequados à sua aplicação antes de os usar em produção.