cURL — Daten über die Kommandozeile übertragen
Praxis-Guide zu cURL — HTTP-Requests, Header, Authentifizierung, Downloads und TLS auf der Kommandozeile, mit Beispielen für jeden Anwendungsfall.
cURL ist das Schweizer Taschenmesser für HTTP auf der Kommandozeile: Mit einem einzigen Befehl rufst du APIs ab, lädst Dateien herunter, testest Endpunkte oder debuggst Header. Das Tool spricht über zwanzig Protokolle – von HTTP und HTTPS über FTP bis SFTP – und ist auf praktisch jedem System vorinstalliert. Dieser Guide zeigt dir die wichtigsten Optionen für den Alltag, vom einfachen GET-Request bis zur Client-Zertifikats-Authentifizierung.
Grundlegende Anfragen
curl <url> — Führt einen einfachen GET-Request aus und gibt die Antwort auf stdout aus.
curl https://api.example.com/userscurl -s <url> — Stiller Modus: unterdrückt Fortschrittsanzeige und Fehlermeldungen.
curl -s https://api.example.com/userscurl -v <url> — Ausführlicher Modus: zeigt Request- und Response-Header zum Debuggen.
curl -v https://api.example.com/userscurl -I <url> — Holt nur die HTTP-Antwort-Header (HEAD-Request).
curl -I https://www.example.comcurl -L <url> — Folgt Weiterleitungen automatisch.
curl -L https://example.com/redirectHeader
curl -H "<header>" <url> — Sendet einen eigenen Request-Header.
curl -H "Accept: application/json" https://api.example.com/userscurl -H "Content-Type: application/json" <url> — Setzt den Content-Type-Header für den Request.
curl -H "Content-Type: application/json" https://api.example.com/userscurl -H "Authorization: Bearer <token>" <url> — Sendet ein Bearer-Token zur Authentifizierung.
curl -H "Authorization: Bearer eyJhbGci..." https://api.example.com/mecurl -A "<user-agent>" <url> — Setzt einen eigenen User-Agent-String.
curl -A "Mozilla/5.0" https://www.example.comDaten senden (POST & PUT)
curl -X POST -d "<data>" <url> — Sendet einen POST-Request mit URL-codierten Formulardaten.
curl -X POST -d "name=John&email=john@example.com" https://api.example.com/userscurl -X POST -H "Content-Type: application/json" -d '<json>' <url> — Sendet einen POST-Request mit JSON-Body.
curl -X POST -H "Content-Type: application/json" -d '{"name":"John"}' https://api.example.com/userscurl -X PUT -d '<data>' <url> — Sendet einen PUT-Request, um eine Ressource zu aktualisieren.
curl -X PUT -H "Content-Type: application/json" -d '{"name":"Jane"}' https://api.example.com/users/1curl -X PATCH -d '<data>' <url> — Sendet einen PATCH-Request für Teil-Aktualisierungen.
curl -X PATCH -H "Content-Type: application/json" -d '{"email":"new@example.com"}' https://api.example.com/users/1curl -X DELETE <url> — Sendet einen DELETE-Request, um eine Ressource zu entfernen.
curl -X DELETE https://api.example.com/users/1curl -F "file=@<path>" <url> — Lädt eine Datei per Multipart-Formulardaten hoch.
curl -F "file=@photo.jpg" https://api.example.com/uploadcurl -d @<file> <url> — Sendet Daten aus einer Datei als Request-Body.
curl -d @data.json -H "Content-Type: application/json" https://api.example.com/usersAuthentifizierung
curl -u <user>:<password> <url> — Sendet einen Request mit Basic-Authentifizierung.
curl -u admin:secret https://api.example.com/admincurl -u <user> <url> — Fragt das Passwort interaktiv ab (sicherer).
curl -u admin https://api.example.com/admincurl --oauth2-bearer <token> <url> — Sendet einen Request mit einem OAuth-2.0-Bearer-Token.
curl --oauth2-bearer eyJhbGci... https://api.example.com/mecurl -b "<cookies>" <url> — Sendet Cookies mit dem Request.
curl -b "session=abc123" https://www.example.com/dashboardcurl -c <file> <url> — Speichert Antwort-Cookies in einer Datei.
curl -c cookies.txt https://www.example.com/loginDownload & Ausgabe
curl -o <file> <url> — Speichert die Antwort in einer bestimmten Datei.
curl -o page.html https://www.example.comcurl -O <url> — Speichert die Antwort unter dem Remote-Dateinamen.
curl -O https://example.com/file.tar.gzcurl -w "%{http_code}" -o /dev/null -s <url> — Gibt nur den HTTP-Statuscode aus.
curl -w "%{http_code}" -o /dev/null -s https://www.example.comcurl -w "%{time_total}" -o /dev/null -s <url> — Misst die gesamte Antwortzeit.
curl -w "%{time_total}" -o /dev/null -s https://www.example.comcurl -C - -O <url> — Setzt einen abgebrochenen Download fort.
curl -C - -O https://example.com/largefile.zipSSL/TLS
curl -k <url> — Überspringt die Prüfung des SSL-Zertifikats (unsicher, nur zum Testen).
curl -k https://self-signed.example.comcurl --cacert <file> <url> — Nutzt ein eigenes CA-Zertifikat zur Prüfung.
curl --cacert ca-bundle.crt https://api.example.comcurl --cert <cert> --key <key> <url> — Nutzt Client-Zertifikats-Authentifizierung.
curl --cert client.crt --key client.key https://api.example.comErweiterte Optionen
curl -x <proxy> <url> — Nutzt einen Proxy-Server für den Request.
curl -x http://proxy.example.com:8080 https://www.example.comcurl --connect-timeout <seconds> <url> — Setzt die maximale Zeit für den Verbindungsaufbau.
curl --connect-timeout 5 https://api.example.comcurl -m <seconds> <url> — Setzt die maximale Zeit für den gesamten Vorgang.
curl -m 30 https://api.example.com/slow-endpointcurl --retry <num> <url> — Wiederholt den Request bei vorübergehenden Fehlern.
curl --retry 3 https://api.example.com/flakycurl -s <url> | jq . — Leitet die JSON-Antwort zur formatierten Ausgabe an jq weiter.
curl -s https://api.example.com/users | jq .Fazit
cURL gehört in das Repertoire jeder Entwicklerin und jedes Administrators: Was als schneller API-Test beginnt, ersetzt rasch ganze Skripte. Wenn du regelmäßig komplexe Requests baust, lohnt sich der Blick auf --config-Dateien und das -w-Ausgabeformat für maschinenlesbare Resultate – so wird aus dem Einzeiler ein wiederverwendbares Werkzeug.
Weiterführende Links
- curl – offizielle Dokumentation – Referenz und Handbuch (englisch)
- curl(1) – Manpage – alle Optionen im Überblick (englisch)
- cURL – Wikipedia – Hintergrund und Geschichte