cURL

curl sendet eine Anfrage vom Terminal und gibt die Antwort aus: Methode mit -X, Header mit -H, Body mit -d und -i zur Anzeige der Antwort-Header. Da ein curl-Befehl jeden Teil einer Anfrage explizit ausgibt, hat er sich als Standardmethode zum Teilen von Anfragen etabliert – in Dokumentationen, Fehlerberichten und über die Option "Copy as cURL" in den Entwicklertools jedes Browsers.

So funktioniert es

-d impliziert POST und einen Formular-Content-Type, sofern Sie nicht -H "Content-Type: application/json" setzen. -L folgt Weiterleitungen, -v zeigt den gesamten Datenaustausch inklusive TLS an, und --fail bewirkt, dass curl bei einem 4xx- oder 5xx-Fehlercode einen anderen Wert als null zurückgibt, um ein Skript zu blockieren. Einfache Anführungszeichen um den Body verhindern, dass die Shell ihn interpretiert.

Das Missverständnis

Sowohl curl als auch ein Browser senden dieselbe Anfrage. Ein Browser fügt Cookies, einen Ursprung, CORS-Preflights und seinen eigenen User-Agent hinzu; curl sendet nur die vom Benutzer angegebenen Daten. Ein Aufruf, der mit curl funktioniert, im Browser aber fehlschlägt, deutet sehr oft auf ein CORS- oder Cookie-Problem hin, nicht auf einen API-Fehler.

Probieren Sie es hier aus

Das „Ausprobieren“-Panel jedes Endpunkts generiert den curl-Befehl für die von Ihnen konfigurierte Anfrage, und der curl-Konverter im Tools-Bereich wandelt jeden curl-Befehl in Code in neun Sprachen um.

Verwandte Inhalte

• curl zu Code-Konverter
• What CORS is

Quellen

• cURL documentation

Weitere Begriffe

• CORS — Die Browserregel, die festlegt, ob JavaScript von einer Domain eine Antwort von einer anderen Domain lesen darf.
• REST-API — Eine API, die ein System als adressierbare Ressourcen modelliert, die mit Standard-HTTP-Methoden manipuliert werden.
• API-Endpunkt — Eine URL plus eine HTTP-Methode – die kleinste Einheit einer API, die ein Client aufrufen kann.
• Abfrageparameter — Die Schlüssel-Wert-Paare nach dem Fragezeichen in einer URL dienen dazu, die Ergebnisse eines Endpunkts zu filtern, zu sortieren, zu paginieren oder zu strukturieren.
• Pfadparameter — Ein variabler Abschnitt eines URL-Pfades, wie zum Beispiel die 42 in /orders/42 , der eine bestimmte Ressource identifiziert.
• HTTP-Header — Name-Wert-Metadaten werden mit jeder Anfrage und Antwort separat vom Nachrichtentext gesendet.

Diese Seite auf Englisch lesen

Alle Glossarbegriffe · Testtechniken · Alle 39 Mock-REST-APIs

Zuletzt aktualisiert 16. Oktober 2026