So starten Sie den Download von Dateien mit cURL

Joseph Grabski

Content-Leiter · Rochester, Vereinigtes Königreich · Bio anzeigen

cURL gehört zum festen Bestandteil des Kommandozeilen-Werkzeugkastens jeder Entwicklerin und jedes Entwicklers und bietet eine schnelle und einfache Möglichkeit, API-Anfragen an beliebige URLs zu senden oder eine Datei bequem von einem Speicherort herunterzuladen. In diesem Leitfaden gehen wir darauf ein, was cURL ist, wie Sie es verwenden und wie Sie damit sogar Ihre Transloadit-Templates testen.

Was ist cURL?

cURL, kurz für „client URL“, ist ein leistungsstarkes Kommandozeilen-Tool und eine Bibliothek für die Datenübertragung über verschiedene Protokolle. Es unterstützt eine Vielzahl von Protokollen, darunter HTTP, HTTPS, FTP und viele weitere, was es zu einer beliebten Wahl für das Herunterladen von Dateien, für API-Anfragen und für die Datenübertragung macht. cURL lässt sich für Aufgaben wie das Herunterladen von Dateien, das Testen von RESTful APIs und sogar das Debuggen von Netzwerkproblemen einsetzen.

Dienste wie Postman EN (English) ermöglichen es Ihnen, cURL hinter einer freundlichen Benutzeroberfläche zu nutzen. Für schnelle Tests auf der Kommandozeile bleibt cURL jedoch ein unverzichtbarer Teil Ihres Entwickler-Werkzeugkastens.

Wie führe ich einen cURL-Befehl aus?

Wenn cURL neu für Sie ist, ist Ihnen vielleicht auch die CLI neu, aber das ist kein Problem! Öffnen Sie zum Einstieg das Terminal (auf einem Mac- oder Linux-Rechner) oder die Eingabeaufforderung (unter Windows) und geben Sie die unten aufgeführten Befehle ein, während wir sie durchgehen. Um zu prüfen, ob Sie an der richtigen Stelle sind, tippen Sie am besten:

echo Hello from Transloadit!

Wenn die Zeile „Hello from Transloadit!“ an Sie zurückgegeben wird, sind Sie an der richtigen Stelle.

Wie lade ich eine Datei mit cURL herunter?

Jetzt, da wir Kommandozeilen-Cowboys sind – starten wir den Download einer Datei mit cURL. Ihr erster Impuls ist vielleicht ein einfacher Befehl wie dieser:

curl URL

Wenn Sie dies jedoch mit einer Website in Ihrem Terminal ausprobieren, werden Sie feststellen, dass nur der Binärcode oder der Quellcode der angefragten Website angezeigt wird.

Der Grund dafür: Im Hintergrund sendet cURL eine HTTP-GET-Anfrage von Ihrem Rechner an die Ziel-URL, und der Server antwortet mit dem rohen HTML, das Sie angefordert haben. Wir haben cURL allerdings nicht mitgeteilt, was wir mit dem HTML machen wollen, deshalb wird es stattdessen einfach im Terminal angezeigt.

Um die Datei auf Ihrem lokalen Rechner zu speichern, statt ihren Inhalt anzuzeigen, fügen Sie das Flag -o hinzu und geben Sie einen Ausgabedateinamen an.

curl -o filename.extension URL

Ersetzen Sie URL durch die tatsächliche URL der gewünschten Datei und sehen Sie mit Genugtuung zu, wie der Download startet.

Wie pausiere ich einen Download mit cURL und setze ihn fort?

Wenn Ihnen das noch nicht Heavy Metal genug war – wie wäre es, wenn wir einen Teil der Funktionalität nachbilden, die das tus-Protokoll⁠ bietet, und zwar mit dem Flag -C für einen Server, der das Fortsetzen von Downloads unterstützt.

Starten Sie den Download auf dieselbe Weise wie im Abschnitt oben. Beenden Sie ihn anschließend, indem Sie im Terminal einfach ctrl+C drücken, um den Prozess zu schließen. Um den Download neu zu starten, geben Sie den folgenden Befehl ein und sehen Sie zu, wie Ihr Download wie von Zauberhand fortgesetzt wird.

curl -C - -o filename.extension URL

Natürlich simulieren wir hier lediglich, was mitten in Ihrem Download versehentlich passieren könnte, etwa wenn Ihre Internetverbindung plötzlich abbricht. Dennoch ist es ein nützlicher Befehl, den Sie für alle Fälle im Hinterkopf behalten sollten.

Wie folge ich Weiterleitungen mit cURL?

HTTP-Weiterleitungen sind seit 1996 ein Kernbestandteil des Webs. Möglicherweise stellen Sie jedoch fest, dass cURL einer Weiterleitungs-URL standardmäßig nicht bis zum endgültigen Ziel folgt. Kein Grund zur Sorge! Wenn wir unserem Befehl das Flag -L hinzufügen, folgt cURL jeder vom Server zurückgegebenen Weiterleitungsanfrage, bis ein endgültiges Ziel erreicht ist. So sieht das aus:

curl -L URL

Wie kann ich ein Transloadit-Template mit cURL testen?

Bevor wir damit beginnen können, Templates mit cURL abzufeuern, müssen wir sicherstellen, dass die Voraussetzungen auf unserem System installiert sind. Das sind (naturgemäß) cURL⁠ und der JSON-Prozessor jq⁠ für die Kommandozeile.

brew install curl jq || sudo apt install curl jq

Sind beide installiert, können wir einen einfachen Befehl erstellen, der eine Multipart-Formularanfrage an die Transloadit-API sendet, um eine Assembly mit dem angegebenen Template auszuführen.

echo '{
  "template_id": "YOUR_TEMPLATE_ID",
  "auth": {
    "key": "YOUR_TRANSLOADIT_KEY"
  },
  "steps": {}
}' | curl \
    --request POST \
    --form 'params=<-' \
    --form myfile1=@./joe-gardner-149699.jpg \
    https://api2.transloadit.com/assemblies \
  | jq

Weitere Informationen zu den Details hinter unserer API finden Sie in unserer umfangreichen Dokumentation, die wir ständig aktualisieren und verbessern. Wenn Sie nicht weiterkommen und lieber mit einem Menschen sprechen möchten, melden Sie sich gerne bei unserem engagierten Team aus Support-Spezialisten.

Fazit

Wenn Sie bis zu diesem Punkt des Blogbeitrags gekommen sind, fühlen Sie sich hoffentlich besser gerüstet, um die cURL-Grundlagen in Ihrem Entwickleralltag einzusetzen. Um über unsere Leitfäden und andere interessante Neuigkeiten aus der Tech-Welt auf dem Laufenden zu bleiben, abonnieren Sie unten unseren monatlichen Newsletter EN (English).