cURL Befehl Generator
Erstelle einen korrekten curl-Befehl, ohne dir Optionen merken zu müssen: Wähle die Methode, gib die URL ein, füge Query-Parameter, Header, einen JSON-, Formular-, Multipart- oder Datei-Body, Authentifizierung und Optionen hinzu. Der Befehl aktualisiert sich beim Tippen, ist korrekt für Bash, Windows CMD oder PowerShell gequotet und kommt mit einer Vorschau der rohen HTTP-Anfrage.
Zuletzt aktualisiert:
Werte werden für dich URL-kodiert. In die URL eingegebene Query-Strings werden automatisch hierher verschoben.
Wähle für ein Dateifeld „Datei“ und gib den lokalen Pfad so ein, wie er im Befehl erscheinen soll (zum Beispiel ./photo.jpg).
Wird Byte für Byte mit --data-binary @file gesendet. Für PUT mit -T file aktiviere in den Optionen „Hochladen mit -T“.
Dein curl-Befehl
Vorschau der HTTP-Anfrage
Der Befehl wird lokal in deinem Browser erstellt. Nichts wird gesendet: Diese Seite kontaktiert die eingegebene URL nie.
Anleitung: cURL Befehl Generator
- Wähle einen Ausgangspunkt wie GET JSON API, POST JSON oder Datei hochladen, oder starte leer.
- Lege Methode und URL fest und füge dann in den jeweiligen Tabs Query-Parameter und Header hinzu.
- Füge einen Body hinzu im Tab Body: JSON, ein Formular, Multipart-Felder und Dateien, Rohtext oder eine Binärdatei.
- Lege Authentifizierung und Optionen fest, etwa Weiterleitungen folgen, Timeouts, Wiederholungen oder eine Ausgabedatei.
- Wähle deine Shell (Bash, CMD oder PowerShell), prüfe eventuelle Warnungen, klicke dann auf Befehl kopieren und füge ihn in dein Terminal ein.
Wichtige curl-Optionen auf einen Blick
| Kurz | Lang | Funktion |
|---|---|---|
-X | --request | Legt die HTTP-Methode fest (PUT, PATCH, DELETE…) |
-H | --header | Fügt einen Request-Header hinzu; -H 'Name;' sendet ihn mit leerem Wert |
-d | --data | Sendet einen formularkodierten Body und wechselt zu POST |
--json | Sendet JSON mit den passenden Content-Type- und Accept-Headern (curl 7.82+) | |
-F | --form | Multipart-Feld; name=@file lädt eine Datei hoch |
-u | --user | Basic-Auth-Zugangsdaten als user:password |
-L | --location | Folgt 3xx-Weiterleitungen |
-i | --include | Gibt die Antwort-Header vor dem Body aus |
-I | --head | Sendet eine HEAD-Anfrage und zeigt nur die Header |
-o | --output | Speichert die Antwort in einer Datei |
-f | --fail | Beendet mit einem Fehler (Code 22) bei HTTP 400 und höher, nützlich in Skripten |
-sS | --silent --show-error | Blendet die Fortschrittsanzeige aus, gibt Fehler aber weiterhin aus |
-m | --max-time | Bricht nach insgesamt so vielen Sekunden ab |
-w | --write-out | Gibt nach der Übertragung Variablen wie %{http_code} oder %{time_total} aus |
Quoting-Regeln je Shell
- Bash und zsh: Einfache Anführungszeichen halten alles wörtlich, daher kann JSON unverändert eingefügt werden. Ein einfaches Anführungszeichen im Wert wird als
'\''geschrieben. Variablen wie$API_TOKENwerden nur innerhalb doppelter Anführungszeichen aufgelöst. - Windows CMD: Nur doppelte Anführungszeichen funktionieren, und innere doppelte Anführungszeichen werden zu
\". Verwende^am Zeilenende, um den Befehl fortzusetzen. Lange JSON-Bodys bewahrst du einfacher in einer Datei auf:-d @body.json. - PowerShell: Rufe
curl.exeauf, nichtcurl. Einfache Anführungszeichen sind wörtlich (ein Anführungszeichen darin wird verdoppelt), ein Backtick setzt die Zeile fort, und$env:NAMEliest eine Umgebungsvariable. Vor PowerShell 7.3 müssen eingebettete doppelte Anführungszeichen zusätzlich als\"escaped werden.
Brauchst du dieselbe Anfrage in Python, JavaScript oder PHP? Füge den fertigen Befehl in den cURL in Code Konverter ein.
Häufige Fragen
Wie sende ich JSON mit curl?
Setze den Content-Type-Header und übergib den Body mit --data-raw (oder -d): curl -H 'Content-Type: application/json' --data-raw '{"name":"Ada"}' https://api.example.com/users. Seit curl 7.82 kannst du --json '{...}' verwenden, das zusätzlich Accept: application/json setzt und automatisch POST nutzt.
Warum steht in meinem Befehl kein -X POST?
curl wechselt von selbst zu POST, wenn du -d, --data-raw, --data-urlencode oder -F übergibst, daher ist -X POST überflüssig. -X POST hinzuzufügen schadet nicht, aber die Kombination von -X mit -L kann nach einer Weiterleitung die falsche Methode beibehalten, deshalb fügt der Generator -X nur hinzu, wenn es etwas ändert.
Was ist der Unterschied zwischen -d, --data-raw, --data-urlencode und -F?
-d sendet Daten als application/x-www-form-urlencoded und behandelt ein führendes @ als Dateinamen. --data-raw ist dasselbe, liest aber nie Dateien. --data-urlencode kodiert den Wert für dich. -F sendet multipart/form-data, was zum Hochladen von Dateien mit name=@pfad nötig ist.
Warum schlägt mein curl-Befehl in PowerShell fehl?
In Windows PowerShell 5.1 ist curl ein Alias für Invoke-WebRequest, daher musst du curl.exe aufrufen. PowerShell-Versionen vor 7.3 entfernen außerdem doppelte Anführungszeichen aus Argumenten, die an Programme übergeben werden, sodass JSON \"-Escapes braucht. Wähle die passende PowerShell-Option und der Generator kümmert sich um beides.
Wie lade ich eine Datei mit curl hoch?
Für einen Upload wie bei einem HTML-Formular verwende Multipart: curl -F 'file=@./photo.jpg' -F 'title=Holiday' https://example.com/upload. Um die Datei als rohen Request-Body zu senden, verwende --data-binary @datei mit einem Content-Type-Header oder -T datei für einen PUT-Upload.
Ist es sicher, Tokens in einen curl-Befehl zu schreiben?
Es funktioniert, aber der Befehl samt Token wird in deinem Shell-Verlauf gespeichert und kann in Prozesslisten auftauchen. Aktiviere „Umgebungsvariablen verwenden“, um stattdessen auf $API_TOKEN, $API_PASSWORD oder $API_KEY zu verweisen, und setze sie vorher in deiner Sitzung.
Sendet dieses Tool die Anfrage?
Nein. Es erstellt nur den Befehlstext in deinem Browser und kontaktiert die URL nie. Führe den Befehl in deinem eigenen Terminal aus oder verwende einen API-Request-Tester, wenn du ihn aus dem Browser senden möchtest.
Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?
Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.