tldr/pages/common/curl.md
Eric Nielsen e0d884efeb curl: Add more download and rewrite data examples (#1023)
- Download: first example introduces `-o`, second one introduces `-O`,
  third example introduces `-L` and `-C` using brackets as per #1018
- Data: first example introduces `-d` (default method is POST and
  default Content-Type is application/x-www-form-urlencoded), second
  example introduces `-X` and `-H`
- Remove "Head request"
- Expand description of "Send form-encoded data" example
2016-08-31 19:33:33 +01:00

1.1 KiB

curl

Transfers data from or to a server. Supports most protocols including HTTP, FTP, POP3.

  • Download the contents of an URL to a file:

curl {{http://example.com}} -o {{filename}}

  • Download a file saving the output under the filename indicated by the URL:

curl -O {{http://example.com/filename}}

  • Download a file, following [L]ocation redirects, and automatically [C]ontinuing/resuming a previous file transfer:

curl -O -L -C - {{http://example.com/filename}}

  • Send form-encoded data (POST request of type application/x-www-form-urlencoded):

curl -d {{'name=bob'}} {{http://example.com/form}}

  • Send data, specifying a custom HTTP method, and including an extra header:

curl -d {{'{"name":"bob"}'}} -X {{PUT}} -H {{'Content-Type: application/json'}} {{http://example.com/users/1234}}

  • Pass a user name and password for server authentication:

curl -u myusername:mypassword {{http://example.com}}

  • Pass client certificate and key for a secure resource:

curl -v -key {{key.pem}} -cacert {{ca.pem}} -cert {{client.pem}} -k {{https://example.com}}