Convertir curl a ColdFusion

cfhttp es la etiqueta y función integrada de ColdFusion para realizar peticiones HTTP. Soporta GET, POST, PUT, DELETE y subidas de archivos con integración nativa en los ámbitos de variables de ColdFusion. No requiere instalación — es parte del runtime de ColdFusion/Lucee. curl2code genera código cfhttp/CFML para las conversiones de ColdFusion.

La etiqueta cfhttp utiliza marcado CFML con atributos nombrados — tradicional, verbosa y legible en archivos de plantilla. La función cfhttp() utiliza CFScript con argumentos entre paréntesis: cfhttp(url=url, method="GET") — moderna y concisa. Ambas compilan a la misma llamada del motor. Utilice CFScript para mantener la consistencia en proyectos ColdFusion modernos. Para opciones de sintaxis similares, consulte curl a PHP.

Añade cabeceras con cfhttpparam type="header" name="Authorization" value="Bearer #token#". Para Basic auth, usa los atributos username y password directamente en cfhttp. ColdFusion maneja la codificación Base64 automáticamente para Basic auth. curl2code convierte los flags de autenticación a CFML.

Usa cfhttpparam type="file" name="upload" file="#filePath#" para subidas de archivos. Para campos de formulario: cfhttpparam type="formfield" name="key" value="value". ColdFusion establece automáticamente el Content-Type multipart y los límites. curl2code maneja las conversiones del flag -F.

Envuélvelo en try/catch: try { httpResult = cfhttp(...); } catch(any e) { ... }. Verifica cfhttp.statusCode para el estado HTTP y cfhttp.errorDetail para información del error. Las respuestas que no son 2xx no lanzan excepciones por defecto — comprueba siempre el código de estado manualmente.

Usa deserializeJSON(cfhttp.fileContent) para parsear JSON en estructuras y arrays de ColdFusion. Para enviar JSON: serializeJSON(data). Las funciones JSON de ColdFusion manejan estructuras anidadas complejas automáticamente, convirtiendo sin problemas entre tipos de datos CFML y JSON.

Pase el parámetro timeout: cfhttp(url=url, timeout=30). El valor se especifica en segundos. No hay un mecanismo de reintento integrado — impleméntelo con un bucle y try/catch. El tiempo de espera por defecto varía según la versión de ColdFusion/Lucee.

Pase los parámetros de proxy: cfhttp(url=url, proxyServer="proxy.host", proxyPort=8080). Para autenticación de proxy, agregue los parámetros proxyUser y proxyPassword. curl2code convierte los flags -x a configuraciones de proxy CFML.

Convierte un comando curl POST como curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL a ColdFusion usando curl2code. El código generado utiliza cfhttpparam type='body' value='#serializeJSON(data)#'. curl2code detecta automáticamente los flags -d/--data con contenido JSON y establece el encabezado Content-Type adecuado en el código de cfhttp.

Pasa curl -H "Authorization: Bearer YOUR_TOKEN" URL a curl2code y este generará código de cfhttp con el encabezado de autorización: cfhttpparam type='header' name='Authorization' value='Bearer TOKEN'. curl2code detecta tokens Bearer tanto en los flags -H "Authorization: Bearer ..." como en --oauth2-bearer. Para Basic auth, utiliza -u user:pass.

curl2code convierte curl -H "Content-Type: application/json" URL a código de cfhttp con el encabezado correcto: cfhttpparam type='header' name='Content-Type' value='application/json'. Para los datos de -d, curl utiliza por defecto application/x-www-form-urlencoded; para subidas de formularios con -F, utiliza multipart/form-data. curl2code mapea cada uno a la API de cfhttp correcta.