Introducción a ibm-watson-cognitive

Obtener credenciales de API

Para autenticarse en los servicios de Watson, necesita credenciales para cada servicio que planea utilizar. Según el servicio, deberá pasar un nombre de usuario y una contraseña con autenticación básica, o deberá pasar una clave API en un parámetro para cada solicitud que realice.

Cómo obtener credenciales para un servicio de Watson:

  1. Regístrese en Bluemix e inicie sesión.
  2. Vaya a la página de servicio para el servicio de Watson deseado:
  3. Seleccione su plan deseado y haga clic en CREAR:

Página del catálogo de servicios de Bluemix

  1. Haga clic en el botón “Credenciales de servicio” en la página del panel de servicio para ver sus credenciales. Si no se le dirige automáticamente al panel de servicio, vaya a su panel de control de Bluemix y haga clic en la instancia de servicio deseada.

Ubicación de las credenciales en el panel de su servicio Bluemix

Uso de los SDK de Watson Developer Cloud

La forma más rápida de comenzar con los servicios de Watson es utilizar los SDK de Watson Developer Cloud. Los siguientes repositorios de GitHub contienen instrucciones de instalación y ejemplos de uso básicos:

Por ejemplo, aquí se explica cómo realizar una llamada a la API de AlchemyLanguage con el SDK de Node.js:

Instale el SDK:

$ npm install watson-developer-cloud

Guarde el siguiente código en un archivo (lo llamaremos app.js). Asegúrate de reemplazar API_KEY con tu clave API.

// Instantiate the service 
var AlchemyLanguageV1= require('watson-developer-cloud/alchemy-language/v1');
var alchemy_language = AlchemyLanguageV1({
  api_key: 'API_KEY'
})

var parameters = {
  extract: [
    'entities',
    'keywords'
  ]
  url: 'https://www.ibm.com/us-en/'
};

alchemy_language.combined(parameters, function (err, response) {
  if (err)
    console.log('error:', err);
  else
    console.log(JSON.stringify(response, null, 2));
});

Ejecute la aplicación:

$ node app.js 

Llamar a las API de Watson con curl

Según el servicio, deberá usar la Autenticación básica con un nombre de usuario y una contraseña o pasar una apikey como parámetro en cada solicitud.

Algunos servicios también admiten autenticación de token.

GET utilizando el analizador de tonos:

curl -X GET \
-u "username":"password" \
-d "version=2016-05-19" \
-d "text=Hey! Welcome to Watson Tone Analyzer!" \
"https://gateway.watsonplatform.net/tone-analyzer/api/v3/tone

POST usando AlchemyLanguage:

curl -X POST \
-d "apikey=YOUR_API_KEY" \
-d "url=www.ibm.com" \
"https://gateway-a.watsonplatform.net/calls/url/URLGetRankedKeywords"