Herramientas de usuario

Diferencias

Muestra las diferencias entre dos versiones de la página.

Enlace a la vista de comparación

Ambos lados, revisión anteriorRevisión previa
Próxima revisión		Revisión previa
tutorial_de_curl [2024/07/06 17:27] – [Estados de Salida] perontutorial_de_curl [2026/04/21 16:09] (actual) – editor externo 127.0.0.1
Línea 1: Línea 1:
-=====Curl=====+=====Tutorial de Curl=====
  
-**curl** significa "cliente para URL". Es un [[cliente]] para lograr transferencias de datos por medio de [[Internet]].+====Introducción==== 
 +**curl** significa "Cliente para URL". Se trata de un programa capaz de realizar transferencias de [[world wide web#internet|Internet]], donde actúa como [[cliente]], cargando y descargando datos desde un [[servidor]] remoto. Los datos pueden responder a cualquier tipología: texto, imágenes, audio, video, etcétera.
  
->Una transferencia de internet es una carga o descarga empleando un protocolo específico (curl soporta varios de ellos), mientras que su punto final resulta identificado por medio de una URL. +Curl soporta tanto protocolos no autenticados (como [[world_wide_web#hipertexto|HTTP]] o [[FTP]]), como sus contrapartes autenticados más modernos (como HTTPS o SFTP). 
- +
-Soporta una gran cantidad de protocolos, desde HTTP, FTP y TELNET a IMAP, LDAP, y GOPHER. Operae en 92 sistemas operativos en cuenta con más de 20 mil millones de instalaciones en todo el mundo. Curl está liberado bajo una licencia MIT ligeramente modificada.+
  
 +===Historia===
 curl comenzó originalmente en 1996 como un proyecto llamado httpget, de Rafael Sagula, quien luego transfirió el control del mismo a Daniel Stenberg. Daniel lo renombró a curl en 1998, y en 2000 dividió la funcionalidad de red de datos para colocarla en la biblioteca libcurl. Por lo cual curl en sí se trasnformó en un envolvedor para la línea de comandos alrededor de dicha biblioteca. curl comenzó originalmente en 1996 como un proyecto llamado httpget, de Rafael Sagula, quien luego transfirió el control del mismo a Daniel Stenberg. Daniel lo renombró a curl en 1998, y en 2000 dividió la funcionalidad de red de datos para colocarla en la biblioteca libcurl. Por lo cual curl en sí se trasnformó en un envolvedor para la línea de comandos alrededor de dicha biblioteca.
  
-En total, Curl+libcurl cuentan con unas 160.000 líneas de código. Curl se actualiza cada 8 semanas y cuenta con unas 250 versiones (agosto de 2023).+Curl se encuentra liberado bajo una licencia MIT ligeramente modificada. Opera en 92 sistemas operativos en cuenta con más de 20 mil millones de instalaciones en todo el mundo. 
 +====Sintaxis de Curl==== 
 +Desde la [[interpretes de comandos|línea de comandos]] operarás el comando ''curl'' , haciendo caso a las reglas de sintaxis del mismo.
  
-Ciclo de Lanzamientos+===Sintaxis básica de Curl===
  
-Luego del lanzamiento, hay 10 días de espera, seguido por una ventana de 21 días para presentar funcionalidades nuevas, seguidas por un período de congelado de 25 días.+Para curl, todo lo que comience con ''-'' o ''--'' lo interpretará como una __opción de curl__.
  
-Curl cuenta con una extensa documentación de referencia. Puede verse una versión corta en línea con +Existen //opciones de curl// que usan sintaxis cortas (con un guión ''-''):
- +
-curl --help +
- +
-Para ver la versión completa, puedes probar con curl --manual  | less +
- +
- +
-====Opciones de la línea de Comando==== +
- +
-Curl se utiliza para realizar transferencias en Internet, donde actúa como [[cliente]], cargando y descargando datos desde un [[servidor]] remoto. Los datos pueden ser de cualquier tipo: texto, imágenes, audio, video, etcétera. +
- +
-Curl soporta tanto protocolos no autenticados (como HTTP o FTP), como sus contrapartes autenticados (como HTTPS o SFTP). Los datos transferidos sobre un protocolo no autenticado pueden ser intereceptados y utilizados, de manera que siempre es mejor usar los autenticados. Curl puede desactivar la verificación de servidor con la opción --insecure, pero es mejor no hacer esto por seguridad. +
- +
-Curl actualmente cuenta con unas 250 opciones. +
- +
-Existen versiones cortas (con un guión)+
  
 <code bash> <code bash>
Línea 36: Línea 23:
 </code> </code>
  
-...y opciones largas (con guión doble):+...y //opciones de curl// de sintaxis largas (usan doble guión ''--''):
  
 <code bash> <code bash>
Línea 42: Línea 29:
 </code> </code>
  
-Todas las opciones están disponibles en el formato "largo", pero las más usadas son las que usan la versión "corta".+> Todas las //opciones de curl// están disponibles en el formato "largo", pero las más usadas son las que usan la versión "corta". El programa cuenta actualmente con unas 250 //opciones//, pero en este tutorial dejaremos de lado aquellas que se usan en otros protocolos distintos a http/https.
  
-====Opciones de Línea de Comandos ====+===Sintaxis complejas=== 
 +Las órdenes más complejas recurren a este tipo de sintaxis.
  
-Algunas opciones son del tipo booleano. Podremos activarlas con+==Opciones Boleanas== 
 +Algunas opciones son del tipo booleano. Podremos activarlas con:
 <code bash> <code bash>
 curl --silent http://httpbin/uuid curl --silent http://httpbin/uuid
 </code> </code>
-o apagarlas:+ 
 +...o desactivarlas con: 
 <code bash> <code bash>
 curl --no-silent http://httpbin/uuid curl --no-silent http://httpbin/uuid
 </code> </code>
-Algunas opciones aceptan argumentos+ 
 +==Opciones Argumentadas== 
 +Algunas opciones de curl aceptan argumentos, que permiten especificarle más definidamente qué es lo que queremos que haga: 
 <code bash> <code bash>
 curl --output /tmp/uuid.json http://httpbin/uuid curl --output /tmp/uuid.json http://httpbin/uuid
 </code> </code>
-Los argumentos que contienen espacios deben ir entrecomillados:+ 
 +Aquellos argumentos que contienen espacios en blanco deben entrecomillarse: ''<nowiki>"..."</nowiki>''. Por ejemplo: 
 <code bash> <code bash>
 curl -o /dev/null --write-out "type: %{content_type}" http://httpbin/uuid curl -o /dev/null --write-out "type: %{content_type}" http://httpbin/uuid
 </code> </code>
-====URLs==== 
  
-Curl soporta URLs (en realidad, URIs) de manera similar a lo que define la RFC 3986:+===Transmisiones No autenticadas=== 
 +Curl puede desactivar la verificación de servidor con la opción ''--insecure'', pero es mejor no hacer esto por seguridad. 
 + 
 +>Los datos transferidos sobre un protocolo no autenticado pueden ser intereceptados y utilizados, de manera que siempre es mejor usar los autenticados.  
 + 
 + 
 +====URLs====
  
-''<nowiki>scheme://user:password@host:port/path?query#fragment</nowiki>''+Todo aquello que pasemos a curl que no comience con ''-'' o ''--'', será considerado una URL. 
  
-  * __scheme__ define un protocolo (como https o ftp). Se es omitido, curl intentará adivinarlo. Los usuarios y contraseñas son credenciales de autenticación (pasar las credenciales en la URL generalmente no se permite por motivos de seguridad). +Curl soporta URLs según la forma de URIs aceptada en la protocolización RFC 3986, o sea: ''<nowiki>esquema://usuaria:contraseña@huésped:puerto/ruta?solicitud#fragmento</nowiki>''. En esta:
-  * __Host__ es el nombre de host, nombre de dominio o dirección IP del servidor. +
-  * __port__ es el número de puerto. Si se omite, curl usará el puerto por defecto asociado con el scheme (tal como 80 para http o 443 para https). +
-  * __path__ es la ruta al recurso en el servidor. +
-  * __query__ es usualmente una secuencia de pares ''nombre=valor'' separada por ''&''.+
  
-Para curl, todo lo que comience con ''-'' o ''--'' es una //opción//, y todo lo demás es una URL.+  * ''esquema'' define un __protocolo__ (como HTTP o FTP). De omitírse, curl intentará adivinarlo. La ''usuaria'' y la ''contraseña'' son __credenciales de autenticación__ (transmitir las credenciales en la URL generalmente no está recomendado o permitido por motivos de seguridad). 
 +  * ''huesped'' es el __nombre de máquina__, __nombre de dominio__ o __dirección IP__ del servidor. 
 +  * ''puerto0'' es el __número de puerto__ de transmisión. De omitirse, curl empleará el puerto por defecto asociado con el esquema (por ejemplo, ''80'' para http o ''443'' para https). 
 +  * ''ruta'' es la __ruta al recurso__ en el servidor. 
 +  * ''solicitud'' es usualmente una secuencia de pares ''nombre=valor'' separada por un caracter ''&''.
  
-====Solicitud====+===Solicitud===
  
-Si debemos pasar un montón de parámetros de URL, la parte de la solicitud puede ser bastante larga. La opción --url-query permite especificar las partes a solicitar de forma separada:+Si fuese necesario pasar a curl una gran cantidad de parámetros de URL, la parte que involucra a la //solicitud// podría resultar extensamente larga. La opción ''--url-query'' permite especificar separadamente estas partes, para que pasarle URL largas nos resulte más cómodo:
  
 <code bash> <code bash>
-curl http://httpbin/get --url-query "name=Alice" --url-query "age=25"+curl http://httpbin/get --url-query "name=Fulana" --url-query "edad=25"
 </code> </code>
  
-====URL Múltiples====+===URL Múltiples===
  
-Curl acepta cualquier número de URLs, cada una de las cuales requiere un destino (ya sea un fichero o stdout). Por ejemplo, este comando guardará la primer UUID en ''/tmp/uuid1.json'' y la segunda UUID como ''/tmp/uuid.json'':+Curl acepta cualquier cantidad de URLs, pero cada una de las cuales requerirá definirle un destino (ya sea un fichero o stdout). Por ejemplo, este comando guardará la primer UUID en ''/tmp/uuid1.json'' y la segunda UUID en ''/tmp/uuid2.json'':
  
 <code bash> <code bash>
Línea 97: Línea 98:
 </code> </code>
  
-(de aquí en mas, en ocasiones mostraré comandos multilíneas a modo ilustrativo. En realidad curl espera una única línea o a lo sumo líneas divididas conm ''\'')+>De aquí en mas, ocasionalmente en este tutorial se mostrarán multilíneas a modo ilustrativo. En realidad curl espera una línea de comando única, o a lo sumo líneas divididas con ''\'').
  
 La opción ''-O'' deriva el nombre de fichero desde la URL: La opción ''-O'' deriva el nombre de fichero desde la URL:
 +
 <code bash> <code bash>
 curl --output-dir /tmp curl --output-dir /tmp
-  -O http://httpbin/anything/one +  -O http://httpbin/cualquier/ruta/uno 
-  -O http://httpbin/anything/two+  -O http://httpbin/cualquier/ruta/dos
  
 && ls /tmp && ls /tmp
 </code> </code>
  
-Para guardar ambas respuestas en el mismo fichero, podemos usar la redirección:+Para guardar ambas respuestas en un mismo fichero, podremos usar [[lenguaje_del_interprete_de_comandos#metacaracteres_de_redireccion|metacaracteres de redirección]]: 
 <code bash> <code bash>
 curl http://httpbin/uuid http://httpbin/uuid > /tmp/uuid.json curl http://httpbin/uuid http://httpbin/uuid > /tmp/uuid.json
Línea 117: Línea 120:
 ===Englobado de URL=== ===Englobado de URL===
  
-Curl expande automáticamente las expresiones englobadas en URLs a múltiples URLs específicas.+Curl expande automáticamente aquellas expresiones englobadas en URLs, en múltiples URLs específicas.
  
-Pore ejemplo, este comando solicita tres rutas distintas (al, bt, gm), cada una con dos parámetros distintos (num=1 y num=2), para totalizar seis URLs:+Por ejemplo, este comando solicita tres rutas distintas (''al'', ''bt'', ''gm''), cada una con dos parámetros distintos (''num=1'' y ''num=2''), totalizando seis URLs:
  
 <code bash> <code bash>
 curl --output-dir /tmp -o "salida_#1_#2.txt" curl --output-dir /tmp -o "salida_#1_#2.txt"
-  http://httpbin/anything/{al,bt,gm}?num=[1-2]+  http://httpbin/cualquier/ruta/{al,bt,gm}?num=[1-2]
  
 && ls /tmp && ls /tmp
 </code> </code>
  
-Podremos desactivar el englobado si usamos la opción --globoff si existen caracteres válidos []{} en las URLs indicadas. Luego Curl los tratará de manera literal.+Si en las URLs indicadas existiesen los caracteres interpretables de englobado (''<nowiki>[]{}</nowiki>''), esto provocaría un tremendo dolor de cabeza. Sin embargo, podremos desactivar su interpretado de englobado gracias a la opción ''--globoff''. De este modo, Curl tratará las URLs de manera literal, sin importar que contengan dichos caracteres.
  
  
 ====Transferencias en paralelo==== ====Transferencias en paralelo====
  
-Es posible usar ''--parallel'' (''-Z'') para indicarle a Curl procesar las URLs de forma concurrente.+Es posible usar la opción ''--parallel'' (''-Z'') para ordenar a Curl el procesado de URLs de forma concurrente.
  
 ====Fichero de Configuración==== ====Fichero de Configuración====
  
-En la medida que se incrementa el número de opciones, el comando Curl se volverá más difícil de descifrar. Para hacerlo más legible, podremos preparar un fichero de configuración que liste una opción por línea (el -- es opcional):+En la medida que se incrementa el número de opciones, el comando Curl se volverá más difícil de descifrar. Para hacerlo más legible, podríamos preparar un fichero de configuración delimitando una opción por línea (el uso de ''--'' es opcional):
  
 +<code>
 Config file Config file
 output-dir /tmp output-dir /tmp
 show-error show-error
 silent silent
 +</code>
  
-Por defecto, Curl lee el fichero de configuración desde ''$HOME/.curlrc'', pero puede cambiar esto indicándolo con la opción  ''--config'' (''-K''):+Por defecto, Curl lee el fichero de configuración desde ''$HOME/.curlrc'', pero esto puede alterarse indicándolo con la opción  ''--config'' (''-K''):
 <code bash> <code bash>
 curl --config /sandbox/.curlrc http://httpbin/uuid curl --config /sandbox/.curlrc http://httpbin/uuid
 </code> </code>
-====Medidores de Progreso==== 
  
-Curl cuenta con dos medidores de progreso. Por defecto es verboso:+====Reseteo de estado==== 
 + 
 +Debemos estar atentos que al configurar las opciones de curl, tal configuración se aplicará a todas las URLs que procese curl. Por ejemplo, aquí ambos encabezados se envían a ambas URLs:
  
 <code bash> <code bash>
-curl --no-silent http://httpbin/uuid+curl 
 +  -H "x-num: uno" http://httpbin/headers?1 
 +  -H "x-num: dos" http://httpbin/headers?2
 </code> </code>
  
-El otro es compacto:+En ocasiones no deseamos hacer esto. Para resetear el estado entre las llamadas a las URLS, debemos recurrir a la opción ''--next'':
  
 <code bash> <code bash>
-curl --no-silent --progress-bar http://httpbin/uuid+curl 
 +  -H "x-num: uno" http://httpbin/encabezados?1 
 +  --next 
 +  -H "x-num: dos" http://httpbin/encabezados?2
 </code> </code>
  
-La opción ''--silent'' apaga completamente el medidor:+ 
 +====Medidor de Progreso==== 
 + 
 +Curl cuenta con dos medidores de progreso distintos para saber cómo va la transferencia ordenada. 
 + 
 +==Indicador de progreso verboso==
  
 <code bash> <code bash>
-curl --silent http://httpbin/uuid+curl --no-silent http://httpbin/uuid
 </code> </code>
  
-====Reseteo de estado====+==Indicador de progreso compacto== 
 +El otro es indicador compactito:
  
-Cuando configuras opciones, se aplican a todas las URLs que procesa Curl. Por ejemplo, aquí ambos encabezados se envían a ambas URLs: 
 <code bash> <code bash>
-curl +curl --no-silent --progress-bar http://httpbin/uuid
-  -H "x-num: one" http://httpbin/headers?1 +
-  -H "x-num: two" http://httpbin/headers?2+
 </code> </code>
  
-A veces esto no es lo que se desea. Para resetear el estado entre las llamadas a URLS, se usa la opción ''--next'':+==Desactivar indicación de progreso== 
 +La opción ''--silent'' desactiva completamente el medidor:
  
 <code bash> <code bash>
-curl +curl --silent http://httpbin/uuid
-  -H "x-num: one" http://httpbin/headers?1 +
-  --next +
-  -H "x-num: two" http://httpbin/headers?2+
 </code> </code>
 +
  
 ====Curl Básico==== ====Curl Básico====
  
-Ahora que entendemos cómo funciona Curl y sus opciones, podremos ver sus opciones específicas.+Ahora que entendemos cómo funciona Curl y la sintaxis de sus opciones, podremos ver sus opciones específicas. 
 +==Versionado== 
 +''--version'' (''-V'') explica todo sobre la versión instalada de curl. Por ejemplo:
  
---version (-V) explica todo sobre la versión instalada de curl: 
 <code bash> <code bash>
 curl -V curl -V
 </code> </code>
-Lista linea a línea las versiones de Curl en sí y sus dependencias, la fecha de lanzamiento, los protocolos disponibles, y las características activadas.+ 
 +...listará linea a línea las versiones de Curl en sí y sus dependencias, la fecha de lanzamiento, los protocolos disponibles, y las características activadas.
  
 ''--verbose'' (''-v'') hace que Curl sea verboso, lo que puede ser útil en depuración: ''--verbose'' (''-v'') hace que Curl sea verboso, lo que puede ser útil en depuración:
 +
 <code bash> <code bash>
 curl -v http://httpbin/uuid curl -v http://httpbin/uuid
 </code> </code>
-Si ''--verbose'' es insuficiente podrías intentar con ''--trace'' (el ''-'' envía la salida de trace a stdout):+ 
 +Si ''--verbose'' es insuficiente, podríamos intentar con el inefable ''--trace'' (el ''-'' envía la salida de trace a stdout): 
 <code bash> <code bash>
 curl --trace - http://httpbin/uuid curl --trace - http://httpbin/uuid
 </code> </code>
-o bien ''--trace-ascii'':+ 
 +...o bien con ''--trace-ascii'': 
 </code bash> </code bash>
 curl --trace-ascii - http://httpbin/uuid curl --trace-ascii - http://httpbin/uuid
 </code> </code>
  
-Usa ''--write-out'' (''-w'') para extraer información específica sobre la respuestas. Soporta más de 50 variables. Por ejemplo, aquí extraemos el código de status y la respuesta del tipo de contenido:+Utiliza ''--write-out'' (''-w'') para extraer información específica sobre la respuestas recibidas. Este soporta más de 50 variables. Por ejemplo, aquí extraemos el código de status y la respuesta del //Content-type//: 
 <code bash> <code bash>
 curl curl
Línea 215: Línea 236:
   http://httpbin/status/429   http://httpbin/status/429
 </code> </code>
 +
 ...o algunos encabezados de la respuesta: ...o algunos encabezados de la respuesta:
 +
 <code bash> <code bash>
 curl curl
Línea 224: Línea 247:
 ====Descargas==== ====Descargas====
  
-''--remote-name'' (''-O'') le dice a curl que guarde la salida a un fichero especificado por la URL, (específicamente, por la parte que sigue a la última / de ésta). A menudo se usa en conjunto con ''--output-dir'', lo que le dice a Curl donde poner exactamente el fichero a guardar:+La opción ''--remote-name'' (''-O'') le dice a curl que guarde la salida en un fichero indicado en base a la URL, (específicamente, por la parte que sigue a la última ''/'' de ésta). A menudo se usa en conjunto con la opción ''--output-dir'', lo que le dirá a Curl exactamente donde colocar el fichero a guardar:
  
 <code bash> <code bash>
Línea 232: Línea 255:
 </code> </code>
  
-Si dicho directorio fuese inexistente, ''--output-dir'' no lo creará por tí. Usa ''--create-dirs'' para que esto suceda:+Si tal directorio es inexistente, ''--output-dir'' no lo creará por tí. Deberás usar ''--create-dirs'' para que esto suceda:
  
 <code bash> <code bash>
Línea 238: Línea 261:
   -O http://httpbin/uuid   -O http://httpbin/uuid
  
-&& cat /tmp/some/place/uuid+&& cat /tmp/alguna/ruta/uuid
 </code> </code>
  
-Puedes usar ''--max-filesize'' (en bytes) para limitar el tamaño de respuesta permitido, pero a menudo no lo sabe por adelantado, de modo que podría fallar.+Puedes usar ''--max-filesize'' (en bytes) para limitar el tamaño máximo de respuesta permitido (aunque esto a menudo no se conoce por adelantado, lo que podría provocar fallas).
  
-====Reintentar====+===Reintentado===
  
-A veces puede que el huésped remoto no esté disponible. Para hacer caso a estas situaciones, Curl provee la opción --retry [num]. Si la solicitud falla, Curl reintentará pero no más de la cantidad de veces indicada num:+A veces puede suceder que el huésped remoto esté indispuesto. Para hacer caso a estas situaciones, Curl provee la opción ''--retry [numero]''. Si la solicitud falla, Curl lo intentará nuevamente, pero no más allá de la cantidad de veces indicada por ''numero'':
  
 <code bash> <code bash>
Línea 253: Línea 276:
 (esta URL falla el 50% de las veces) (esta URL falla el 50% de las veces)
  
-Podrás indicar la cantidad máxima de tiempo con la que Curl reintentará la solicitud con la opción ''--retry-max-time'' (en segundos) o el retrato entre reintentos con ''--retry-delay'' (también en segundos):+Podrás indicar la cantidad máxima de tiempo que Curl invertirá en intentar nuevamente la solicitud, por medio de  la opción ''--retry-max-time'' (segundos), o bien el retraso entre reintentos, con ''--retry-delay'' (también en segundos):
  
 <code bash> <code bash>
Línea 261: Línea 284:
 </code> </code>
  
-Para Curl, "request failed" significa alguno de los códigos HHTP: 408, 429, 500, 502, 503 o 504. Si la solicitud falla con un error de "connection refused", Curl no reintentará. Pero puede cambiarse esto con --retry-connrefused, o incluso activar los reintentos para todo tipo de problemas con --retry-all-errors.+Para Curl, "request failed" implica recibir alguno de los códigos de respuesta HTTP: ''408'', ''429'', ''500'', ''502'', ''503'' o ''504''. Si la solicitud falla con un error de "connection refused", Curl __no intentará nuevamente__. Sin embargo, este funcionamiento típico puede alterarse con la opción ''--retry-connrefused'', o incluso activar los reintentos para todo tipo de problemas con la opción ''--retry-all-errors''.
  
 ====Subidas==== ====Subidas====
  
-Curl a menudo se usa para bajar información (descargar) del servidor, pero también puede subirla. Para ello use la opción --upload-file (-T):+Curl a menudo se usa para bajar información (descargar) del servidor, pero también puede subirla. Para ello use la opción ''--upload-file'' (''-T''):
  
 <code bash> <code bash>
-echo hola > /tmp/hola.txt &&+echo "hola Tercer Mundo!" > /tmp/hola.txt &&
  
 curl -T /tmp/hola.txt http://httpbin/put curl -T /tmp/hola.txt http://httpbin/put
 </code> </code>
  
-Para cargas HTTP, Curl usa el método PUT.+Para las cargas de datos a través de protocolo HTTP, Curl usa el método PUT.
  
 ===Controles de Transferencia=== ===Controles de Transferencia===
  
-Para detener descargas lentas, configure la velocidad de descarga mínima permitida (en bytes por segundo) con --speed-limit. Por defecto, Curl revisa la velocidad en intervalos de 30 segunods, pero esto puede cambiarse con --speed-time.+Para detener las descargas lentas, debe configurar la velocidad de descarga mínima permitida (en bytes por segundo) con ''--speed-limit''. Por defecto, Curl revisa la velocidad en intervalos de 30 segundos, pero este comportamiento típico puede ser modificado con la opción ''--speed-time''.
  
 Por ejemplo, para permitir no menos de 10 bytes/segundo durante un intervalo de 3 segundos: Por ejemplo, para permitir no menos de 10 bytes/segundo durante un intervalo de 3 segundos:
 +
 <code bash> <code bash>
 curl -v --speed-limit 10 --speed-time 3 http://httpbin/get curl -v --speed-limit 10 --speed-time 3 http://httpbin/get
 </code> </code>
  
-Para limitar el uso de ancho de banda, utilice --limit-rate. Acepta cualquier cantidad, desde bytes a petabytes:+Para limitar el uso de ancho de banda, utiliza la opción ''--limit-rate''. Esta acepta cualquier cantidad, desde bytes a petabytes:
  
 <code bash> <code bash>
Línea 306: Línea 330:
 ===Resolución de nombre=== ===Resolución de nombre===
  
-Por defecto, curl usa tu servidor DNS para resolver los nombres de host a direcciones IP. Pero puedes forzarlo a resolver una IP específica con ''--resolve'':+Por defecto, curl usa tu servidor DNS para resolver desde nombres de huésped a direcciones IP. Pero puedes forzarlo a resolver una IP específica por medio de la opción ''--resolve'':
  
 <code bash> <code bash>
-curl --resolve httpbingo.org:8080:127.0.0.1+curl --resolve texto-plano.xyz:80:127.0.0.1
   http://httpbingo.org:8080/get</code>   http://httpbingo.org:8080/get</code>
 +</code>
  
 +...(este falla porque nadie escucha en 127.0.0.1)
  
-(este falla porque nadie escucha en 127.0.0.1) +O puedes incluso mapear un par ''maquina:puerto'' a otro par ''maquina:puerto'' con ''--connect-to'':
- +
-O puedes incluso mapear un par ''hostname:puerto'' a otro par ''hostname:puerto'' con ''--connect-to'':+
  
 <code bash> <code bash>
-curl --connect-to httpbingo.org:8080:httpbin:80 +curl --connect-to texto-plano.xyz:443:texto-plano:80 
-  http://httpbingo.org:8080/get+  http://texto-plano.xyz:443/
 </code> </code>
  
Línea 333: Línea 357:
  
 <code bash>curl --max-time 0.5 http:/httpbin/delay/1</code> <code bash>curl --max-time 0.5 http:/httpbin/delay/1</code>
- 
- 
 (este falla) (este falla)
  
Línea 340: Línea 362:
  
 <code bash>curl --connect-timeout 0.5 http:/httpbin/delay/1</code> <code bash>curl --connect-timeout 0.5 http:/httpbin/delay/1</code>
- 
- 
 (este funciona bien) (este funciona bien)
  
 ===Credenciales=== ===Credenciales===
  
-Casi nunca querrás pasar nombre de usuario y contraseña en el comando de curl en s{i. Una forma de evitarlo es usar el fichero ''~/netrc''. Especifica los nombres de host y credenciales para accederlos:+Casi nunca querrás pasar nombre de usuario y contraseña en el comando de curl en sí. Una forma de evitarlo es usar el fichero ''$HOME/netrc''. Especifica los nombres de máquina y credenciales para accederlos:
  
 <code> <code>
Línea 377: Línea 397:
 Puede acceder al status de salida a través de la variable de intérprete ''$?''. Puede acceder al status de salida a través de la variable de intérprete ''$?''.
  
-====HTTP====+===HTTP===
  
 Principalmente, Curl se usa para trabajar con HTTP, de modo que hablemos un poco de esto. Principalmente, Curl se usa para trabajar con HTTP, de modo que hablemos un poco de esto.
Línea 569: Línea 589:
  
 >Las condiciones Timestamp confían en el encabezado de respuesta Last-Modified ("modificado por última vez"), de modo que si el servidor no lo ofrece, el recurso siempre será considerado el más actual. Lo mismo sucede para las condiciones etag y para el encabezado de respuesta Etag. >Las condiciones Timestamp confían en el encabezado de respuesta Last-Modified ("modificado por última vez"), de modo que si el servidor no lo ofrece, el recurso siempre será considerado el más actual. Lo mismo sucede para las condiciones etag y para el encabezado de respuesta Etag.
 +
 +===Envío HTTP===
 +
 +''POST'' envía datos al servidor. Por defecto, es un conjunto de pares clave-valor condificados en una sola cadena con un encabezado //Content-Type// ''application/x-www-form-urlencoded''.
 +
 +Puede usar ''--data'' (''-d'') para especificar los pares clave-valor individualmente (o para la cadena entera):
 +
 +<code bash>
 +curl -d name=fulana -d edad=25 http://httpbin/post
 +</code>
 +
 +
 +Para enviar datos desde un fichero, usamos ''@'' con la ruta del fichero. Usamos ''--header'' (''-H'') para cambiar el encabezado //Content-Type// de acuerdo a los contenidos del fichero:
 +
 +<code bash>
 +echo "Fulana, edad 25" > /tmp/data.txt &&
 +
 +curl -d @/tmp/datos.txt -H "content-type: text/plain"
 +  http://httpbin/post
 +</code>
 +
 +
 +''--data-raw'' envía datos de manera similar a ''--data'', pero sin interpretar el caracter ''@''.
 +
 +Para enviar datos JSON, usamos ''--json''. Automáticamente cambiará los encabezados //Content-Type// y //Accept// de manera acorde:
 +
 +<code bash>
 +curl --json '{"nombre": "fulana"}' http://httpbin/post
 +</code>
 +
 +
 +==Solicitudes JSON==
 +Usamos ''jo'' y ''jq'' para simplificar el trabajo con JSON.
 +
 +Para condificar datos de URL-encode (escapar todos los símbolos no permitidos en las URLs), use el ''--data-urlencode'':
 +
 +<code bash>
 +curl --data-urlencode "Nombre: Fulana Mengana" http://httpbin/post
 +</code>
 +
 +==Envío de formularios multiparte==
 +
 +''POST'' puede enviar tados como una secuencia de "partes" con un timpo de contenido ''multipart/form-data''. Esto se usa a menudo para formularios HTML que contienen tanto campos de texto y ficheros.
 +
 +Cada parte tiene un nombre, encabezados, y datos. Las parte se separan por una "frontera mime" (27 guiones e identificador alfanumérico de 16 caracteres), de esta manera:
 +
 +<code>
 +--------------------------d74496d66958873e
 +Content-Disposition: form-data; nombre="persona"
 +
 +Anónimo
 +--------------------------d74496d66958873e
 +Content-Disposition: form-data; nombre="secret"; filename="fichero.txt"
 +Content-Type: text/plain
 +
 +contenidos del fichero
 +--------------------------d74496d66958873e--
 +</code>
 +
 +Para construir estas solicitudes multipartes con curl, usamos ''--form'' (''F''). Cada una de estas opciones agrega una parte a la solicitud:
 +
 +<code bash>
 +touch /tmp/fulana.png &&
 +
 +curl -F nombre=Fulana -F edad=25 -F foto=@/tmp/fulana.png
 +  http://httpbin/post
 +</code>
 +
 +===Redirecciones===
 +
 +Una redirección sucede cuando el servidor, en lugar de devolver el recurso solicitado, le dice al cliente que el recurso está localizado en otro lado (como se indica en el encabezado de Locación). La redirección siempre tiene un código de respuesta ''3xx''.
 +
 +Por defecto, Curl no sigue el redireccionamiento, y devuelve una respuesta similar a:
 +
 +<code bash>
 +curl -i http://httpbin/redirect/1
 +</code>
 +
 +Para hacer que Curl sigua redirecciones, use ''--follow'' (''-L''):
 +
 +<code bash>
 +curl -L http://httpbin/redirect/1
 +</code>
 +
 +Para protegerse contra redirecciones en bucle sinfín, use el limitador ''--max-redirs'', por ejemplo:
 +
 +<code bash>
 +curl -L --max-redirs 3 http://httpbin/redirect/10
 +</code>
 +
 +===HTTP PUT===
 +
 +A menudo se usa el método ''PUT'' para enviar ficheros al servidor. Para esto, use ''--upload-file'' (''-T''):
 +
 +<code bash>
 +echo "Hola Tercer Mundo!" > /tmp/hola.txt &&
 +
 +curl -T /tmp/hola.txt http://httpbin/put
 +</code>
 +
 +En ocasiones, se utiliza ''PUT'' para hacer solicitudes a APIs REST. Para ellas, utilice ''--request'' (''-X'') para establecer el método, y ''--data'' (''-d'') para enviar los datos:
 +
 +<code bash>
 +curl -X PUT -H "content-type: application/json"
 +  -d '{"nombre": "fulana"}'
 +  http://httpbin/put
 +</code>
 +
 +==Cookies==
 +
 +El protocolo HTTP carece de estado, y las cookies fueron concebidas como un método ingenioso para sortear esto, siguiendo este mecanismo general:
 +
 +  * El servidor desea asociar algún estado con la sesión del cliente.
 +  * El servidor devuelve el estado en el encabezado de respueta Set-Cookie.
 +  * El cliente reconoce las cookies y las envía de vuelta con cada solicitud incorporada al encabezado de solicitud de la cookie.
 +
 +Cada cookie tiene una fecha de vencimiento - ya sea explífita o una de "fin de sesión" (en los clientes de navegación, esto a menudo sucede cuando se cierra el [[navegador web|navegador]])
 +
 +Por defecto, Curl ignora las cookies. Para activarlas, use la opción ''--cookie'' (''-b''). Para hacer que curl haga persistir las cookies entre llamadas, use ''--cookie-jar'' (''-c'').
 +
 +>Aunque su reputación ha sido ensuciada por los infames "baneos de cookies", las cookies siguen siendo uno de los mejores ejemplos de nombrado de funcionalidad.
 +
 +Aquí el servidor establece la //sessionid de cookie// al valor ''123456'' y curl la almacena en el jarro de cookies siguado en ''/tmp/cookies'':
 +
 +<code bash>
 +curl -b "" -c /tmp/cookies
 +  http://httpbin/cookies/set?sessionid=123456
 +
 +&& cat /tmp/cookies
 +</code>
 +
 +...Las llamadas subsecuentes con ''-b /tmp/cookies'' enviarán la cookie con la //sessionid// indicada de vuelta al servidor.
 +
 +Curl descarta automáticamente las cookies del jarro de cookies cuando superan su vencimiento  (esto requiere una fecha de vencimiento explícita configurada por el servidor). Para desccartar las cookies basadas en sesión, use ''--junk-session-cookies'' (''-j''):
 +
 +<code bash>
 +curl -j -b /tmp/cookies http://httpbin/get
 +</code>
 +
 +===Servicios alternativos===
 +
 +El encabezado de respuesta HTTP //Alt-Svc// indica que existe otra localización de red (un servicio alternativo) que el cliente podría utilizar para solicitudes futuras.
 +
 +Para permitir los servicios alternativos, use ''--alt-svc''. Esto le dice a curl que almacenee dichos servicios en un fichero especificado, y los considere para solicitudes futuras.
 +
 +<code bash>
 +curl --alt-svc /tmp/servicios_alternativos -o /dev/null
 +  http://httpbin/get
 +
 +&& cat /tmp/servicios_alternativos
 +</code>
 +
 +===Seguridad Estricta de Transporte HTTP===
 +
 +El encabezado de respuesta HTTP //Strict-Transport-Security// (también conocido como HSTS) informa al cliente que el servidor sólo debe ser accedido a través de HTTPS, y que cualquier intento futuro de accederlo a través de HTTP debe ser convertido a HTTPS automáticamente.
 +
 +Para hacer que curl respete esta represión impuesta por el HSTS, use ''--hsts''. Esto hará que curl almacene los servidores con HSTS activado en un fichero especificado, y convierta automáticamente las solicitudes http a https cuando las acceda.
 +
 +<code bash>
 +curl --hsts /tmp/hsts -o /dev/null
 +  http://httpbin/get
 +
 +&& cat /tmp/hsts
 +</code>
 +
 +====Documentación====
 +Curl cuenta con una extensa documentación de referencia. Puedes verla con:
 +<code bash>
 +curl --help
 +</code>
 +
 +Para ver la versión completa del manual, puedes probar con:
 +<code bash>curl --manual  | less</code>
 +
 +====Conclusión====
 +Curl es una de las herramientas predilectas para las transferencias electrónicas, e intentar dominarlo en texto-plano.xyz requiere alardearlo con [[gab]]:
 +
 +<code bash>
 +gab -m "¡Aprendí a usar curl, la “navaja suiza del hacker” en texto-plano.xyz!"
 +</code>
 +
 +

Este sitio web utiliza cookies para guardar datos esenciales de su actividad, como su autenticación. Al entrar acepta el uso de cookies.

Más información