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