Usando curl com exemplos Watson

O utilitário curl permite que você faça pedidos HTTP da linha de comando. O utilitário fornece uma interface simples para fazer pedidos que usam GET, POSTe outros métodos HTTP. Ele permite que você passe a solicitar cabeçalhos, dados e outras entradas, e ele pode exibir todos os cabeçalhos de resposta e dados que uma chamada retorna. Como curl elimina a necessidade de gravar código para exercitar APIs REST, IBM Watson® usa-se a documentação curl para demonstrar chamadas de exemplo.

O utilitário curl é instalado por padrão com versões recentes do Apple ® macOS® e do Microsoft® Windows®.

Para obter mais informações sobre como instalar ou atualizar curl em macOS, Windows ou Linux®, consulte Instalar curl.
Para obter mais informações sobre o uso do curl e sua gama completa de capacidades, veja Everything curl.

curl não é recomendado para desenvolvimento de aplicativos.

Como usar curl para comunicações seguras

Para testar se curl está instalado em seu sistema, execute o seguinte comando em um prompt de terminal:

curl -V

Se a saída lista https entre os protocolos suportados e SSL (Secure Sockets Layer) ou TLS (Transport Layer Security) entre os recursos suportados, você estará todo configurado. Todos os serviços IBM Watson Watson utilizam esses recursos para conexões seguras entre o cliente e o servidor. Uma solicitação de conexão é verificada em relação à loja de certificados local para garantir autenticação, integridade e confidencialidade.

Se esses protocolos não forem listados, você pode usar um certificado auto-assinado para seus pedidos. Mas para fazer uma conexão bem-sucedida, é necessário desativar a verificação SSL incluindo a opção --insecure ou -k com a solicitação.

A ativação da verificação SSL é altamente recomendada. A desativação do SSL coloca em risco a segurança da conexão e dos dados. Desabilite o SSL apenas se necessário e apenas com dados que não sejam confidenciais, e tome etapas para ativar o SSL o mais rápido possível.

Exemplo de pedidos de curl

Os exemplos a seguir demonstram o uso de curl. Os pedidos usam o serviço Speech to Text para transcrever áudio para texto com ambos IBM Cloud® e 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"

Em ambos os exemplos, você substitui {url} pelo URL para sua instância de serviço. A autenticação difere entre IBM Cloud®, onde você substitui {apikey} pela chave API para sua instância de serviço, e IBM Cloud Pak® for Data, onde você substitui {token} por um token de acesso que você gera para a sua instância de serviço. Para obter mais informações sobre a autenticação no serviço em qualquer plataforma, consulte Autenticando para os serviços Watson.

Ao enviar solicitações com base em exemplos na documentação, omitida o aparelho ({ }) a partir dos exemplos; eles indicam valores variáveis que você deve substituir por valores reais. Os usuários do Windows devem substituir a barra backslash (\) no final de cada linha com um careta (^). Certise-se de que não há espaços de trilhas após um \ ou ^.