Exemples d'utilisation de curl avec Watson

L'utilitaire curl vous permet d'effectuer des demandes HTTP à partir de la ligne de commande. L'utilitaire fournit une interface simple permettant d'effectuer des demandes qui utilisent GET, POSTet d'autres méthodes HTTP. Il vous permet de transmettre des en-têtes de demande, des données et d'autres entrées, et il peut afficher tous les en-têtes de réponse et les données renvoyées par un appel. Etant donné que curl élimine la nécessité d'écrire du code pour l'exercice des API REST, la documentation IBM Watson® utilise curl pour illustrer des exemples d'appels.

L'utilitaire curl est installé par défaut avec les versions récentes d'Apple ® macOS® et de Microsoft® Windows®.

Pour plus d'informations sur l'installation ou l'actualisation de curl sous macOS, Windows ou Linux®, voir Installation de curl.
Pour plus d'informations sur l'utilisation de curl et de sa gamme complète de fonctionnalités, voir Everything curl.

curl n'est pas recommandé pour le développement d'applications.

Utilisation de curl pour les communications sécurisées

Pour tester si curl est installé sur votre système, exécutez la commande suivante à l'invite du terminal:

curl -V

Si la sortie répertorie https parmi les protocoles pris en charge et SSL (Secure Sockets Layer) ou TLS (Transport Layer Security) parmi les fonctions prises en charge, vous êtes tous défini. Tous les services IBM Watson Watson utilisent ces fonctions pour des connexions sécurisées entre le client et le serveur. Une demande de connexion est vérifiée par rapport au magasin de certificats local pour garantir l'authentification, l'intégrité et la confidentialité.

Si ces protocoles ne sont pas répertoriés, vous pouvez utiliser un certificat autosigné pour vos demandes. Mais pour établir une connexion réussie, vous devez désactiver la vérification SSL en incluant l'option --insecure ou -k avec la demande.

L'activation de la vérification SSL est fortement recommandée. La désactivation de SSL compromet la sécurité de la connexion et des données. Désactivez SSL uniquement si nécessaire et uniquement avec des données non confidentielles, et prenez les mesures nécessaires pour activer SSL dès que possible.

Exemples de demandes curl

Les exemples suivants illustrent l'utilisation de curl. Les demandes utilisent le service Speech to Text pour transcrire l'audio en texte avec IBM Cloud® et IBM Cloud Pak® for Data.

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"

Dans les deux exemples, vous remplacez {url} par l'URL de votre instance de service. L'authentification diffère entre IBM Cloud®, où vous remplacez {apikey} par la clé d'API de votre instance de service, et IBM Cloud Pak® for Data, où vous remplacez {token} par un jeton d'accès que vous générez pour votre instance de service. Pour plus d'informations sur l'authentification auprès du service sur l'une des plateformes, voir Authentification auprès des services Watson.

Lorsque vous soumettez des demandes basées sur des exemples dans la documentation, omettez les accolades ({ }) dans les exemples ; elles indiquent les valeurs de variable que vous devez remplacer par des valeurs réelles. Les utilisateurs Windows doivent remplacer la barre oblique inversée (\) à la fin de chaque ligne par un caret (^). Assurez-vous qu'il n'y a pas d'espaces de fin après un \ ou un ^.