Cómo empezar a descargar archivos con cURL
cURL es un elemento básico del kit de herramientas de línea de comandos de cualquier desarrollador, ya que ofrece una forma rápida y sencilla de lanzar peticiones API a cualquier URL o de descargar fácilmente un archivo desde una ubicación. En esta guía veremos qué es cURL, cómo usarlo e incluso cómo puedes usarlo para probar tus Templates de Transloadit.
¿Qué es cURL?
cURL, abreviatura de «client URL», es una potente herramienta y biblioteca de línea de comandos para transferir datos mediante diversos protocolos. Admite una amplia gama de protocolos, como HTTP, HTTPS, FTP y muchos más, lo que la convierte en una opción popular para descargar archivos, hacer peticiones API y transferir datos. cURL se puede usar para tareas como descargar archivos, probar API RESTful e incluso depurar problemas de red.
Servicios como Postman (English) te permiten usar cURL desde una interfaz de usuario amigable. Sin embargo, para hacer pruebas rápidas en la línea de comandos, cURL puede seguir siendo una parte inestimable de tu kit de herramientas de desarrollo.
¿Cómo ejecuto un comando de cURL?
Si eres nuevo en el uso de cURL, puede que también seas nuevo en el uso de la CLI, ¡pero no pasa nada! Para empezar, abre la terminal (en un equipo Mac o Linux) o el símbolo del sistema (en Windows) e introduce los comandos que se muestran a continuación a medida que avancemos. Una buena forma de comprobar si estás en el lugar correcto es escribir:
echo Hello from Transloadit!
Si ves la línea «Hello from Transloadit!» repetida en pantalla, estás en el lugar correcto.
¿Cómo descargo un archivo con cURL?
Ahora que ya somos vaqueros de la línea de comandos, empecemos a descargar un archivo con cURL. Puede que tu primer instinto sea usar un comando sencillo como este:
curl URL
Sin embargo, si pruebas esto con un sitio web en tu terminal, notarás que solo muestra el binario o el código fuente del sitio web que estás solicitando.
Esto se debe a que, internamente, cURL envía una petición HTTP GET desde tu equipo a la URL de destino, y el servidor responde con el HTML sin procesar que solicitaste. Sin embargo, no le hemos dicho a cURL qué queremos hacer con el HTML, así que simplemente se muestra en la terminal.
Para guardar el archivo en tu equipo local en lugar de mostrar su contenido, añade la opción -o
y especifica un nombre de archivo de salida.
curl -o filename.extension URL
Sustituye URL por la URL real del archivo que quieres y observa con satisfacción cómo comienza
la descarga.
¿Cómo pauso y reanudo una descarga con cURL?
Si eso no te ha parecido suficientemente heavy metal, probemos a replicar parte de la funcionalidad
que ofrece el protocolo tus, usando la opción -C con un servidor que admita la reanudación de descargas.
Inicia la descarga de la misma forma que en la sección anterior. Después, termina la descarga
simplemente pulsando ctrl+C en la terminal para cerrar el proceso. Para reiniciar la descarga, escribe
el comando que aparece a continuación y observa cómo tu descarga se reanuda por arte de magia.
curl -C - -o filename.extension URL
Por supuesto, lo que hacemos aquí es simplemente simular lo que podría ocurrir de forma accidental en mitad de tu descarga, como que tu conexión a internet se corte de repente, pero puede ser un comando útil que conviene tener presente por si acaso.
¿Cómo sigo las redirecciones con cURL?
Las redirecciones HTTP son una pieza fundamental de la web desde 1996. Sin embargo, quizá notes que
cURL, de forma predeterminada, no sigue una URL de redirección hasta el destino final. ¡Pero no hay
de qué preocuparse! Al añadir la opción -L
a nuestro comando, cURL seguirá cada petición de redirección que devuelva el servidor hasta llegar a
un destino final. Así se vería:
curl -L URL
¿Cómo puedo probar un Template de Transloadit con cURL?
Antes de empezar a lanzar Templates con cURL, tenemos que asegurarnos de que los requisitos previos estén instalados en nuestro sistema. Estos son (como es natural) cURL y el procesador de JSON de línea de comandos jq.
brew install curl jq || sudo apt install curl jq
Una vez instalados ambos, podemos crear un comando sencillo que envía una petición de formulario multiparte a la API de Transloadit, para ejecutar una Assembly con el Template especificado.
echo '{
"template_id": "YOUR_TEMPLATE_ID",
"auth": {
"key": "YOUR_TRANSLOADIT_KEY"
},
"steps": {}
}' | curl \
--request POST \
--form 'params=<-' \
--form myfile1=@./joe-gardner-149699.jpg \
https://api2.transloadit.com/assemblies \
| jq
Para obtener más información sobre los detalles de nuestra API, contamos con documentación exhaustiva que actualizamos y mejoramos constantemente. Si te has atascado y prefieres hablar con una persona, no dudes en ponerte en contacto con nuestro equipo de especialistas de soporte.
Conclusión
Si has llegado hasta este punto del blog, esperamos que ahora te sientas mejor preparado para usar los fundamentos de cURL en tu día a día como desarrollador. Para mantenerte al día con nuestras guías y otras novedades interesantes del mundo tecnológico, suscríbete a nuestro boletín mensual (English) más abajo.