Acces la rețea și la distanță

Comanda curl

Trimiteți cereri HTTP și descărcați date

Linux · Exemple Bash · comenzile rulează pe serverul selectat

Când să utilizați curl

Utilizați curl pentru a inspecta răspunsurile HTTP, pentru a descărca o resursă sau pentru a apela un API de pe server. Separați succesul transportului de succesul aplicației, setați timeout-uri sensibile și țineți tokenurile de autentificare departe de exemplele de comandă salvate.

Sintaxă

curl [PARAMETERS] URL

Parantezele pătrate marchează argumente opționale; o elipsă înseamnă repetiție. Înlocuiți exemple de nume de fișiere, nume de utilizator și adrese de server cu propriile valori.

Opțiuni și argumente comune

-I
Solicitați numai anteturi HTTP, folosind metoda HEAD.
-f
Returnează o eroare pentru codurile de stare HTTP 400 și mai sus.
-L
Urmăriți redirecționări; -o specifică fișierul rezultat.

Exemple de utilizare

Verificați anteturile site-ului

curl -I https://example.com

Se face o cerere numai pentru antet; unele servicii gestionează acest lucru în mod diferit față de o solicitare normală de conținut.

Descărcați fișierul cu procesarea erorilor HTTP

curl --fail --location --output ./page.html https://example.com

Redirecționările sunt urmate și corpul răspunsului înlocuiește fișierul local numit; Stările de eroare HTTP cauzează eșec.

Solicitați JSON cu limită de timp

curl --fail --max-time 15 -H 'Accept: application/json' https://example.com/api/status

Este solicitat un răspuns JSON cu o durată totală limitată; punctul final trebuie să furnizeze de fapt acel API.

Note și limitări

  • Cu HTTPS certificatul este verificat implicit; nu dezactivați verificarea prin -k fără un motiv separat.
  • Nu plasați jetoane sau parole reale în istoricul comenzilor și nu rulați scripturi descărcate fără verificare.

Întrebări frecvente și depanare

De ce reușește curl când serverul returnează o pagină de eroare?

Fără opțiunea de eșec, primirea unui răspuns de eroare HTTP poate conta în continuare ca un transfer reușit. Inspectați atât starea HTTP, cât și starea de ieșire a comenzii.

Ar trebui să dezactivez verificarea certificatului pentru a remedia HTTPS?

Nu ocoli încrederea ca o soluție de rutină. Verificați în schimb numele gazdei, ora sistemului, lanțul de certificate de server și configurația CA de încredere.

Ajutor suplimentar

Opțiunile variază în funcție de versiune și distribuție. Verificați documentația instalată cu această comandă: man curl.