Utilizzo di curl con esempi Watson

Il programma di utilità curl consente di effettuare richieste HTTP dalla riga comandi. Il programma di utilità fornisce un'interfaccia semplice per effettuare richieste che utilizzano GET, POSTe altri metodi HTTP. Consente di trasmettere intestazioni di richiesta, dati e altri input e può visualizzare tutte le intestazioni di risposta e i dati restituiti da una chiamata. Poiché curl elimina la necessità di scrivere codice per provare le API REST, la documentazione IBM Watson® utilizza curl per dimostrare chiamate di esempio.

Il programma di utilità curl è installato per default con le versioni più recenti di Apple ® macOS® e Microsoft® Windows®.

Per ulteriori informazioni sull'installazione o sull'aggiornamento di curl su macOS, Windows o Linux®, vedi Install curl.
Per ulteriori informazioni sull'utilizzo di curl e della sua gamma completa di funzionalità, consulta Everything curl.

curl non è consigliato per lo sviluppo dell'applicazione.

Utilizzo di curl per comunicazioni sicure

Per verificare se curl è installato sul proprio sistema, eseguire il seguente comando da un prompt di terminale:

curl -V

Se l'output elenca https tra i protocolli supportati e SSL (Secure Sockets Layer) o TLS (Transport Layer Security) tra le funzioni supportate, si è tutti impostati. Tutti i servizi IBM Watson Watson utilizzano queste funzioni per connessioni sicure tra il client e il server. Una richiesta di connessione viene verificata rispetto all'archivio certificati locale per garantire l'autenticazione, l'integrità e la riservatezza.

Se questi protocolli non sono elencati, è possibile utilizzare un certificato autofirmato per le richieste. Ma per stabilire una connessione corretta, devi disabilitare la verifica SSL includendo l'opzione --insecure o -k con la richiesta.

L'abilitazione della verifica SSL è altamente consigliata. La disattivazione di SSL compromette la sicurezza della connessione e dei dati. Disabilitare SSL solo se necessario e solo con dati non confidenziali e adottare le misure necessarie per abilitare SSL il più presto possibile.

Richieste curl di esempio

I seguenti esempi dimostrano l'utilizzo di curl. Le richieste utilizzano il servizio Speech to Text per trascrivere l'audio nel testo sia con IBM Cloud® che con 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"

In entrambi gli esempi, sostituisci {url} con l'URL della tua istanza del servizio. L'autenticazione differisce tra IBM Cloud®, dove sostituisci {apikey} con la chiave API per la tua istanza del servizio e IBM Cloud Pak® for Data, dove sostituisci {token} con un token di accesso che generi per la tua istanza del servizio. Per ulteriori informazioni sull'autenticazione al servizio su una piattaforma, vedi Autenticazione ai servizi Watson.

Quando si inoltrano le richieste in base agli esempi nella documentazione, omettere le parentesi graffe ({ }) dagli esempi; indicano i valori delle variabili che devono essere sostituiti con i valori effettivi. Gli utenti Windows devono sostituire la barra rovesciata (\) alla fine di ogni riga con un accento circonflesso (^). Assicurarsi che non vi siano spazi finali dopo un \ o un ^.