Mreža i daljinski pristup

Naredba curl

Pošaljite HTTP zahtjeve i preuzmite podatke

Linux · Bash primjeri · naredbe se izvode na odabranom poslužitelju

Kada koristiti curl

Upotrijebite curl za pregled odgovora HTTP, preuzimanje resursa ili pozivanje API s poslužitelja. Odvojite uspjeh prijenosa od uspjeha aplikacije, postavite razumna vremena čekanja i držite autentifikacijske tokene izvan spremljenih primjera naredbi.

Sintaksa

curl [PARAMETERS] URL

Uglate zagrade označavaju neobavezne argumente; elipsa znači ponavljanje. Zamijenite primjere naziva datoteka, korisničkih imena i adresa poslužitelja vlastitim vrijednostima.

Uobičajene opcije i argumenti

-I
Zatražite samo zaglavlja HTTP, koristeći metodu HEAD.
-f
Vrati pogrešku za statusne kodove HTTP 400 i više.
-L
Slijedite preusmjeravanja; -o navodi datoteku rezultata.

Primjeri uporabe

Provjerite zaglavlja stranice

curl -I https://example.com

Izrađuje se zahtjev samo za zaglavlje; neke usluge to obrađuju drugačije od uobičajenog zahtjeva za sadržajem.

Preuzmite datoteku s obradom pogrešaka HTTP

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

Slijede se preusmjeravanja i tijelo odgovora zamjenjuje imenovanu lokalnu datoteku; Statusi grešaka HTTP uzrokuju kvar.

Zahtjev JSON s vremenskim ograničenjem

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

Traži se odgovor JSON s ograničenim ukupnim trajanjem; krajnja točka mora zapravo osigurati da API.

Napomene i ograničenja

  • Uz HTTPS certifikat se verificira prema zadanim postavkama; nemojte onemogućiti provjeru putem -k bez posebnog razloga.
  • Ne stavljajte stvarne tokene ili lozinke u povijest naredbi i ne pokrećite preuzete skripte bez provjere.

Uobičajena pitanja i rješavanje problema

Zašto curl uspijeva kada poslužitelj vrati stranicu s pogreškom?

Bez opcije neuspjeha, primanje odgovora o pogrešci HTTP i dalje se može računati kao uspješan prijenos. Pregledajte status HTTP i status izlaza naredbe.

Trebam li onemogućiti provjeru certifikata da popravim HTTPS?

Nemojte zaobilaziti povjerenje kao rutinsko rješenje. Umjesto toga provjerite naziv glavnog računala, vrijeme sustava, lanac certifikata poslužitelja i pouzdanu CA konfiguraciju.

Dodatna pomoć

Opcije se razlikuju ovisno o verziji i distribuciji. Provjerite instaliranu dokumentaciju ovom naredbom: man curl.