Foaie de referință cURL
O referință curl căutabilă și imprimabilă — metode HTTP, anteturi, date și formulare, autentificare, descărcări, cookie-uri, TLS, proxy-uri și depanare. Gratuit.
Bazele
12curl https://api.example.com
Trimite o cerere GET și afișează corpul
curl -o page.html https://example.com
Salvează răspunsul într-un fișier cu nume
curl -O https://example.com/file.zip
Salvează folosind numele fișierului remote
curl -i https://example.com
Afișează antetele răspunsului plus corpul
curl -I https://example.com
Obține doar antetele răspunsului (HEAD)
curl -v https://example.com
Ieșire detaliată a cererii/răspunsului
curl -s https://example.com
Mod silențios, ascunde progresul și erorile
curl -sS https://example.com
Silențios dar afișează totuși erorile
curl -L https://example.com
Urmează redirecționările HTTP (3xx)
curl https://a.com https://b.com
Cere mai multe URL-uri într-un singur apel
curl 'https://x.com/p?[1-5]'
Folosește un interval numeric pentru a parcurge URL-uri
curl --version
Afișează versiunea curl și funcționalitățile
Metode HTTP
9curl -X GET https://api.example.com
Trimite explicit o cerere GET
curl -X POST https://api.example.com
Trimite o cerere POST
curl -X PUT https://api.example.com/1
Trimite o cerere PUT pentru a înlocui o resursă
curl -X PATCH https://api.example.com/1
Trimite o cerere PATCH pentru a actualiza câmpuri
curl -X DELETE https://api.example.com/1
Trimite o cerere DELETE
curl -I https://api.example.com
Trimite o cerere HEAD doar pentru antete
curl -X OPTIONS https://api.example.com
Trimite o cerere OPTIONS de preflight
curl --head https://api.example.com
Forma lungă a -I pentru o cerere HEAD
curl --request POST https://x.com
Forma lungă a -X pentru a seta metoda
Antete
10curl -H 'Accept: application/json' https://x.com
Adaugă un singur antet de cerere
curl -H 'X-Token: abc' -H 'X-Env: dev' https://x.com
Adaugă mai multe antete
curl -H 'Content-Type: application/json' https://x.com
Declară tipul de conținut al corpului cererii
curl -H 'Authorization: Bearer TOKEN' https://x.com
Trimite un antet de autorizare bearer
curl -H 'Host: example.com' https://1.2.3.4
Suprascrie antetul Host
curl -H 'Accept-Encoding: gzip' https://x.com
Cere un răspuns comprimat gzip
curl -A 'MyAgent/1.0' https://x.com
Setează șirul User-Agent
curl -e 'https://ref.com' https://x.com
Setează antetul Referer
curl -H 'X-Debug:' https://x.com
Elimină un antet implicit lăsându-l gol
curl --compressed https://x.com
Cere și decomprimă automat răspunsul
Trimitere date
11curl -d 'name=Jane&age=30' https://x.com
POST date de formular codificate URL
curl -d '@payload.json' https://x.com
POST date citite dintr-un fișier
curl --data-urlencode 'q=hello world' https://x.com
POST un singur câmp codificat URL
curl --data-binary '@file.bin' https://x.com
POST octeți bruti fără procesare
curl -G --data-urlencode 'q=cats' https://x.com
Adaugă datele ca șir de interogare GET
curl -X POST -H 'Content-Type: application/json' -d '{"name":"Jane"}' https://x.com
POST un corp JSON
curl --json '{"name":"Jane"}' https://x.com
POST JSON și setează automat antetele JSON
curl -F 'name=Jane' https://x.com
Trimite un câmp de formular multipart
curl -F 'file=@photo.png' https://x.com
Încarcă un fișier ca form-data multipart
curl -F 'file=@a.pdf;type=application/pdf' https://x.com
Încarcă un fișier cu tip MIME explicit
curl -d '' https://x.com
POST cu un corp gol
Autentificare
9curl -u user:pass https://x.com
Autentificare HTTP basic
curl -u user https://x.com
Auth basic, solicită parola
curl -H 'Authorization: Bearer TOKEN' https://x.com
Trimite un antet cu token bearer
curl --oauth2-bearer TOKEN https://x.com
Trimite un token bearer OAuth 2.0
curl --digest -u user:pass https://x.com
Folosește autentificare HTTP digest
curl --ntlm -u user:pass https://x.com
Folosește autentificare NTLM
curl --netrc https://x.com
Citește credențialele din ~/.netrc
curl --netrc-file creds https://x.com
Citește credențialele dintr-un fișier netrc personalizat
curl -H 'X-Api-Key: KEY' https://x.com
Trimite un antet cu cheie API
Descărcare și încărcare
11curl -O https://x.com/file.zip
Descarcă folosind numele fișierului remote
curl -o out.zip https://x.com/file.zip
Descarcă într-un nume de fișier ales
curl -OL https://x.com/file.zip
Descarcă și urmează redirecționările
curl -C - -O https://x.com/file.zip
Reia o descărcare parțială
curl --limit-rate 200k -O https://x.com/f
Limitează viteza de transfer
curl -r 0-1023 -o part https://x.com/f
Descarcă doar un interval de octeți
curl --retry 3 -O https://x.com/f
Reîncearcă descărcarea la eșec
curl -T file.txt ftp://x.com/
Încarcă un fișier cu PUT/FTP
curl -T file.txt https://x.com/up
Încarcă un fișier prin HTTP PUT
curl --create-dirs -o a/b/f.txt https://x.com
Creează directoarele lipsă pentru ieșire
curl -# -O https://x.com/file.zip
Afișează o bară de progres simplă
Cookie-uri
8curl -b 'session=abc123' https://x.com
Trimite un cookie inline
curl -b cookies.txt https://x.com
Trimite cookie-uri dintr-un fișier
curl -c cookies.txt https://x.com
Scrie cookie-urile primite într-un jar
curl -b jar.txt -c jar.txt https://x.com
Citește și actualizează același cookie jar
curl -b 'a=1; b=2' https://x.com
Trimite mai multe cookie-uri deodată
curl -c - https://x.com
Afișează cookie-urile primite la stdout
curl --junk-session-cookies -b jar.txt https://x.com
Ignoră cookie-urile de sesiune din jar
curl -L -c jar.txt -b jar.txt https://x.com/login
Păstrează o sesiune între redirecționări
TLS / SSL
10curl -k https://x.com
Permite nesigur (omite verificarea certificatului)
curl --cacert ca.pem https://x.com
Verifică cu un bundle CA personalizat
curl --capath /etc/ssl/certs https://x.com
Folosește un director de certificate CA
curl --cert client.pem https://x.com
Trimite un certificat de client
curl --cert client.pem --key client.key https://x.com
Folosește un certificat de client și o cheie privată
curl --tlsv1.2 https://x.com
Necesită cel puțin TLS 1.2
curl --tlsv1.3 https://x.com
Necesită cel puțin TLS 1.3
curl --tls-max 1.2 https://x.com
Limitează versiunea TLS maximă
curl --ciphers ECDHE-RSA-AES128-GCM-SHA256 https://x.com
Restricționează cifrurile TLS permise
curl -vI https://x.com
Inspectează detaliile handshake-ului TLS
Proxy-uri
9curl -x http://proxy:8080 https://x.com
Direcționează cererea printr-un proxy HTTP
curl --proxy http://proxy:8080 https://x.com
Forma lungă a -x pentru a seta un proxy
curl -x proxy:8080 -U user:pass https://x.com
Autentifică-te la proxy
curl --proxy-user user:pass -x proxy:8080 https://x.com
Forma lungă a credențialelor de proxy
curl --socks5 127.0.0.1:1080 https://x.com
Folosește un proxy SOCKS5
curl --socks5-hostname 127.0.0.1:1080 https://x.com
Proxy SOCKS5 cu rezolvare DNS remote
curl --socks4 127.0.0.1:1080 https://x.com
Folosește un proxy SOCKS4
curl --noproxy example.com https://x.com
Ocolește proxy-ul pentru anumite host-uri
curl -x '' https://x.com
Dezactivează orice proxy configurat
Depanare și ieșire
11curl -w '%{http_code}\n' -o /dev/null -s https://x.com
Afișează doar codul de stare HTTP
curl -w '%{time_total}\n' -o /dev/null -s https://x.com
Afișează timpul total de transfer
curl -w '@format.txt' https://x.com
Citește formatul write-out dintr-un fișier
curl -D headers.txt https://x.com
Salvează antetele răspunsului într-un fișier
curl -D - -o body.txt https://x.com
Antetele la stdout, corpul într-un fișier
curl --trace trace.txt https://x.com
Trasare hex completă a transferului
curl --trace-ascii - https://x.com
Trasare ASCII la stdout
curl --trace-time -v https://x.com
Adaugă marcaje de timp la ieșirea detaliată
curl -v https://x.com 2>&1 | less
Parcurge paginat log-ul detaliat
curl -sS -o /dev/null -w '%{size_download}\n' https://x.com
Afișează numărul de octeți descărcați
curl --libcurl out.c https://x.com
Emite sursă C libcurl echivalentă
Timeout-uri și reîncercări
10curl --connect-timeout 5 https://x.com
Limitează faza de conectare în secunde
curl --max-time 30 https://x.com
Limitează timpul întregii operațiuni
curl --retry 3 https://x.com
Reîncearcă la erori tranzitorii
curl --retry 3 --retry-delay 2 https://x.com
Așteaptă între încercările de reîncercare
curl --retry 5 --retry-max-time 60 https://x.com
Limitează timpul total petrecut reîncercând
curl --retry-connrefused https://x.com
Reîncearcă și la conexiune refuzată
curl --retry-all-errors https://x.com
Reîncearcă la orice eroare, nu doar tranzitorie
curl --speed-limit 100 --speed-time 10 https://x.com
Abandonează dacă e prea lent o anumită durată
curl --keepalive-time 60 https://x.com
Setează intervalul keep-alive TCP
curl --expect100-timeout 1 https://x.com
Limitează așteptarea pentru un 100-continue
Nicio intrare nu corespunde cu „:q”.
Ai nevoie de ajutor?
Ai întâmpinat o problemă cu acest instrument? Spune-ne.