CURL

El comando curl es una herramienta para transferir datos de cliente a servidor o servidor a cliente. Admite una gran variedad de protocolos como FTP, HTTP, IMAP, LDAP, POP3, SCP, SMTP, etc, por lo que soporta características como uso de proxies, autenticación, subida de archivoss, conexiones SSL, cookies y muchas otras más.

Vamos a ver casos prácticos enfocados a peticiones HTTP y HTTPS.

Para ejecutar una petición GET a un servidor y mostrar su respuesta ejecutaremos el comando curl seguido de la URL del servidor. Ejemplo:

$ curl https://www.google.com.ar

Si queremos guardar la respuesta utilizaremos el flag -o (--output) indicando la ruta de un archivos:

$ curl -o ./google-response.txt https://www.google.com.ar

Alternativamente podemos utilizar el comando redirección (> o >>) para redirigir la salida a la ruta del archivos que queremos guardar.

Si queremos descargarnos un archivos con el nombre de la URL podemos utilizar el flag -O (--remote-name) para indicar a curl que descargue el contenido de la respuesta en un archivos con el mismo nombre que el de la URL. Ejemplo para descargar una imagen:

$ curl -O http://bootcamp.295devops.com/img/295.png

Podemos utilizar el flag -L (--location) junto a -O para seguir redirecciones.

Podemos hacer debugging de las cabeceras y conexión utilizando el flag -v (--verbose):

curl -v https://www.google.com.ar

Si queremos mostrar sólo las cabeceras de respuesta podemos utilizar el flag -I:

$ curl -I https://www.google.com.ar

Podemos cambiar el user agent utilizando el flag -A (--user-agent):

## Comprueba las respuestas con y sin el flag. Esta API es capaz de detectar peticiones curl.
$ curl -A "None" https://wttr.in/

Podemos modificar las headers de petición utilizando el flag -H <header>: <value> por cada cabecera. Ejemplo:

## La siguiente API es capaz de responder en diferentes formatos (JSON, XML, HTML, YAML).
$ curl -H "Accept: application/xml" mockbin.org/request
$ curl -H "Accept: application/json" mockbin.org/request

Para realizar peticiones con diferente verbo HTTP (POST, PUT, DELETE, PATCH, etc) utilizaremos el flag -X <method>. El siguiente ejemplo realiza una petición POST con datos enviados como JSON utilizando el flag -d (--data):

curl -X POST -d '{"title": "Post title", "body": "Post content", "userId": 1}' -H 'Content-Type: application/json' https://jsonplaceholder.typicode.com/posts

Podemos especificar si utilizar HTTP1.1 o HTTP2 mediante los flags --http1.1 y --http2 respectivamente.

Si necesitamos guardar las cabeceras de respuesta podemos utilizar el flag -D (--dump-header <filename>) y el nombre de un archivos.

$ curl -D mockbin-response-headers.txt mockbin.org/request

Si utilizamos -D - volcará las cabeceras en la salida de consola.