Options de requête
Méthode, en-têtes, corps, cookies, authentification, proxy… à la manière de curl.
Ces options s'ajoutent à la commande de téléchargement et l'emportent sur le profil.
| Option | Rôle |
|---|---|
-X, --method METHOD | Méthode HTTP (GET par défaut) |
-H, --header "Nom: valeur" | En-tête, répétable ; ${VAR} est remplacé par la variable d'environnement |
-d, --data TEXT | Corps texte |
--data-file FILE | Corps lu depuis un fichier |
--json JSON | Corps JSON (ajoute Content-Type: application/json) |
-b, --cookie "a=1; b=2" | Cookies |
--cookies-file FILE | Fichier cookies.txt au format Netscape |
-u, --user nom[:mot de passe] | Authentification Basic ; le mot de passe est demandé s'il manque |
-e, --referer URL | En-tête Referer |
-A, --user-agent UA | User-Agent |
--proxy URL | Proxy http://, https:// ou socks5:// |
--max-redirs N | Redirections maximales (10 par défaut) |
--timeout SECONDS | Délai d'expiration |
-k, --insecure | Accepte n'importe quel certificat TLS (dangereux) |
-o, --output NAME | Nom du fichier final (sans dossier) |
--data, --data-file et --json sont exclusifs.
Méthodes autres que GET
Un POST (ou PUT…) n'est jamais rejoué par segment : il est envoyé une seule fois et téléchargé en un seul flux, pour éviter les effets de bord côté serveur.
Exemple
turbodl-cli default https://api.example.com/export \
-X POST --json '{"format":"csv"}' \
-H "Authorization: Bearer ${API_TOKEN}" \
-o export.csv