Converter curl para ColdFusion

cfhttp é a tag e função integrada do ColdFusion para fazer pedidos HTTP. Suporta GET, POST, PUT, DELETE e uploads de ficheiros com integração nativa nos âmbitos de variáveis do ColdFusion. Não é necessária instalação — faz parte do runtime ColdFusion/Lucee. O curl2code gera código cfhttp/CFML para conversões ColdFusion.

A tag cfhttp utiliza marcação CFML com atributos nomeados — tradicional, verbosa e legível em ficheiros de template. A função cfhttp() utiliza CFScript com argumentos entre parênteses: cfhttp(url=url, method="GET") — moderna e concisa. Ambas compilam para a mesma chamada do motor. Utilize CFScript para consistência em projetos ColdFusion modernos. Para escolhas de sintaxe semelhantes, veja curl para PHP.

Adicione cabeçalhos com cfhttpparam type="header" name="Authorization" value="Bearer #token#". Para autenticação Basic, utilize os atributos username e password diretamente no cfhttp. O ColdFusion lida com a codificação Base64 automaticamente para autenticação Basic. O curl2code converte as flags de autenticação para CFML.

Utilize cfhttpparam type="file" name="upload" file="#filePath#" para uploads de ficheiros. Para campos de formulário: cfhttpparam type="formfield" name="key" value="value". O ColdFusion define o Content-Type multipart e os boundaries automaticamente. O curl2code lida com as conversões da flag -F.

Envolva em try/catch: try { httpResult = cfhttp(...); } catch(any e) { ... }. Verifique cfhttp.statusCode para o estado HTTP e cfhttp.errorDetail para informações de erro. Respostas não-2xx não lançam exceções por predefinição — verifique sempre o código de estado manualmente.

Utilize deserializeJSON(cfhttp.fileContent) para analisar JSON em structs e arrays do ColdFusion. Para enviar JSON: serializeJSON(data). As funções JSON do ColdFusion lidam com estruturas complexas aninhadas automaticamente, convertendo entre tipos de dados CFML e JSON de forma transparente.

Passe o parâmetro timeout: cfhttp(url=url, timeout=30). O valor é em segundos. Não existe repetição integrada — implemente com um loop e try/catch. O timeout predefinido varia consoante a versão do ColdFusion/Lucee.

Passe os parâmetros de proxy: cfhttp(url=url, proxyServer="proxy.host", proxyPort=8080). Para autenticação de proxy, adicione os parâmetros proxyUser e proxyPassword. O curl2code converte as flags -x para definições de proxy CFML.

Converta um comando curl POST como curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL para ColdFusion usando o curl2code. O código gerado utiliza cfhttpparam type='body' value='#serializeJSON(data)#'. O curl2code deteta automaticamente as flags -d/--data com conteúdo JSON e define o cabeçalho Content-Type apropriado no código cfhttp.

Passe curl -H "Authorization: Bearer YOUR_TOKEN" URL para o curl2code e este gera código cfhttp com o cabeçalho de autenticação: cfhttpparam type='header' name='Authorization' value='Bearer TOKEN'. O curl2code deteta tokens Bearer tanto de flags -H "Authorization: Bearer ..." como de --oauth2-bearer. Para Basic auth, utilize -u user:pass.

O curl2code converte curl -H "Content-Type: application/json" URL para código cfhttp com o cabeçalho correto: cfhttpparam type='header' name='Content-Type' value='application/json'. Para dados -d, o curl assume por defeito application/x-www-form-urlencoded; para envios de formulários -F, utiliza multipart/form-data. O curl2code mapeia cada um para a API cfhttp correta.