IBM Cloud Docs
Utilización de curl con ejemplos de Watson

Utilización de curl con ejemplos de Watson

El programa de utilidad curl le permite realizar solicitudes HTTP desde la línea de mandatos. El programa de utilidad proporciona una interfaz simple para realizar solicitudes que utilizan GET, POSTy otros métodos HTTP. Le permite pasar cabeceras de solicitud, datos y otra entrada, y puede visualizar todas las cabeceras de respuesta y los datos que devuelve una llamada. Puesto que curl elimina la necesidad de escribir código para ejercer las API REST, la documentación de IBM Watson® utiliza curl para mostrar llamadas de ejemplo.

El programa de utilidad curl se instala de forma predeterminada con las versiones recientes de Apple ® macOS® y Microsoft® Windows®.

  • Para obtener más información sobre la instalación o renovación de curl en macOS, Windows o Linux®, consulte Instalar curl.
  • Para obtener más información sobre cómo utilizar curl y su gama completa de prestaciones, consulte Everything curl.

No se recomienda curl para el desarrollo de aplicaciones.

Utilización de curl para comunicaciones seguras

Para probar si curl está instalado en el sistema, ejecute el mandato siguiente en un indicador de terminal:

curl -V

Si la salida lista https entre los protocolos soportados y SSL (capa de sockets seguros) o TLS (seguridad de la capa de transporte) entre las características soportadas, está todo establecido. Todos los servicios IBM Watson Watson utilizan estas características para conexiones seguras entre el cliente y el servidor. Se verifica una solicitud de conexión en el almacén de certificados local para garantizar la autenticación, la integridad y la confidencialidad.

Si estos protocolos no se listan, puede utilizar un certificado autofirmado para las solicitudes. Pero para realizar una conexión satisfactoria, debe inhabilitar la verificación SSL incluyendo la opción --insecure o -k con la solicitud.

Se recomienda encarecidamente habilitar la verificación SSL. La inhabilitación de SSL pone en peligro la seguridad de la conexión y los datos. Inhabilite SSL sólo si es necesario y sólo con datos que no son confidenciales, y tome medidas para habilitar SSL lo antes posible.

Solicitudes curl de ejemplo

Los ejemplos siguientes muestran el uso de curl. Las solicitudes utilizan el servicio Speech to Text para transcribir el audio al texto con IBM Cloud® y 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"

En ambos ejemplos, sustituya {url} por el URL de la instancia de servicio. La autenticación difiere entre IBM Cloud®, donde sustituye {apikey} por la clave de API para la instancia de servicio, y IBM Cloud Pak® for Data, donde sustituye {token} por una señal de acceso que genera para la instancia de servicio. Para obtener más información sobre la autenticación en el servicio en cualquiera de las plataformas, consulte Autenticación en servicios de Watson.

Al enviar solicitudes basadas en ejemplos de la documentación, omita las llaves ({ }) de los ejemplos; indican valores de variable que debe sustituir por valores reales. Los usuarios de Windows deben sustituir la barra inclinada invertida (\) al final de cada línea por un signo de intercalación (^). Asegúrese de que no haya espacios finales después de un \ o ^.