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
, POST
e 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 ^
.