Opciones de petición
Método, cabeceras, cuerpo, cookies, autenticación, proxy… al estilo de curl.
Estas opciones se añaden al comando de descarga y tienen prioridad sobre el perfil.
| Opción | Función |
|---|---|
-X, --method METHOD | Método HTTP (GET por defecto) |
-H, --header "Nombre: valor" | Cabecera, repetible; ${VAR} se sustituye por la variable de entorno |
-d, --data TEXT | Cuerpo de texto |
--data-file FILE | Cuerpo leído de un archivo |
--json JSON | Cuerpo JSON (añade Content-Type: application/json) |
-b, --cookie "a=1; b=2" | Cookies |
--cookies-file FILE | Archivo cookies.txt en formato Netscape |
-u, --user nombre[:contraseña] | Autenticación Basic; la contraseña se pide si falta |
-e, --referer URL | Cabecera Referer |
-A, --user-agent UA | User-Agent |
--proxy URL | Proxy http://, https:// o socks5:// |
--max-redirs N | Redirecciones máximas (10 por defecto) |
--timeout SECONDS | Tiempo de espera |
-k, --insecure | Acepta cualquier certificado TLS (peligroso) |
-o, --output NAME | Nombre del archivo final (sin carpeta) |
--data, --data-file y --json son excluyentes.
Métodos distintos de GET
Un POST (o PUT…) nunca se repite por segmento: se envía una sola vez y se descarga en un único flujo, para evitar efectos secundarios en el servidor.
Ejemplo
turbodl-cli default https://api.example.com/export \
-X POST --json '{"format":"csv"}' \
-H "Authorization: Bearer ${API_TOKEN}" \
-o export.csv