Verwendung von 'curl' mit Watson -Beispielen

Mit dem Dienstprogramm curl können Sie HTTP-Anforderungen über die Befehlszeile absetzen. Das Dienstprogramm stellt eine einfache Schnittstelle für Anforderungen bereit, die GET-, POST-und andere HTTP-Methoden verwenden. Damit können Sie Anforderungsheader, Daten und andere Eingaben übergeben und alle Antwortheader und Daten anzeigen, die von einem Aufruf zurückgegeben werden. Da curl das Schreiben von Code zum Ausüben von REST-APIs überflüssig macht, verwendet die IBM Watson® -Dokumentation curl zur Veranschaulichung von Beispielaufrufen.

Das Dienstprogramm curl wird standardmäßig mit aktuellen Versionen von Apple ® macOS® und Microsoft® Windows®installiert.

Weitere Informationen zur Installation oder Aktualisierung von curl unter macOS, Windows oder Linux®finden Sie unter Install curl.
Weitere Informationen zur Verwendung von curl und dem gesamten Funktionsumfang finden Sie unter Everything curl.

curl wird für die Anwendungsentwicklung nicht empfohlen.

curl für sichere Kommunikation verwenden

Führen Sie den folgenden Befehl an einer Eingabeaufforderung des Terminals aus, um zu testen, ob curl auf Ihrem System installiert ist:

curl -V

Wenn die Ausgabe https unter den unterstützten Protokollen und SSL (Secure Sockets Layer) oder TLS (Transport Layer Security) unter den unterstützten Features auflistet, sind Sie alle eingestellt. Alle IBM Watson Watson -Services verwenden diese Funktionen für sichere Verbindungen zwischen Client und Server. Eine Verbindungsanforderung wird anhand des lokalen Zertifikatsspeichers überprüft, um Authentifizierung, Integrität und Vertraulichkeit sicherzustellen.

Wenn diese Protokolle nicht aufgelistet sind, können Sie ein selbst signiertes Zertifikat für Ihre Anforderungen verwenden. Für eine erfolgreiche Verbindung müssen Sie jedoch die SSL-Verifizierung inaktivieren, indem Sie die Option --insecure oder -k in die Anforderung einschließen.

Die Aktivierung der SSL-Verifizierung wird dringend empfohlen. Die Inaktivierung von SSL gefährdet die Sicherheit der Verbindung und der Daten. Inaktivieren Sie SSL nur bei Bedarf und nur mit Daten, die nicht vertraulich sind, und ergreifen Sie Maßnahmen, um SSL so schnell wie möglich zu aktivieren.

Beispiel für curl-Anforderungen

Die folgenden Beispiele veranschaulichen die Verwendung von curl. Die Anforderungen verwenden den Service Speech to Text , um Audio in Text mit IBM Cloud® und IBM Cloud Pak® for Datazu transkribieren.

IBM Cloud

curl -X POST -u "apikey:{apikey}" \
--header "Content-Type: audio/flac" \
--data-binary ./audio-file.flac \
"{url}/v1/recognize"

IBM Cloud Pak for Data

curl -X POST \
--header "Authorization: Bearer {token}" \
--header "Content-Type: audio/flac" \
--data-binary ./audio-file.flac \
"{url}/v1/recognize"

In beiden Beispielen ersetzen Sie {url} durch die URL für Ihre Serviceinstanz. Die Authentifizierung unterscheidet sich zwischen IBM Cloud®, wobei Sie {apikey} durch den API-Schlüssel für Ihre Serviceinstanz ersetzen, und IBM Cloud Pak® for Data, wobei Sie {token} durch ein Zugriffstoken ersetzen, das Sie für Ihre Serviceinstanz generieren. Weitere Informationen zur Authentifizierung beim Service auf beiden Plattformen finden Sie unter Authentifizierung bei Watson -Services.

Wenn Sie Anforderungen basierend auf Beispielen in der Dokumentation übergeben, lassen Sie die geschweiften Klammern ({ }) aus den Beispielen weg. Sie geben Variablenwerte an, die Sie durch tatsächliche Werte ersetzen müssen. Windows-Benutzer müssen den Backslash (\) am Ende jeder Zeile durch ein Winkelzeichen (^) ersetzen. Stellen Sie sicher, dass nach \ oder ^keine nachfolgenden Leerzeichen folgen.