Inicio rápido: Revisión ortográfica con la API REST de Bing Spell Check y Node.js

Utiliza esta guía rápida para realizar tu primera llamada a la Bing Spell Check REST API. Esta sencilla aplicación de JavaScript envía una solicitud a la API y devuelve una lista de correcciones sugeridas.

Aunque esta aplicación está escrita en JavaScript, la API es un servicio web RESTful compatible con la mayoría de los lenguajes de programación. El código fuente de esta aplicación está disponible en GitHub.

Prerrequisitos

• Node.js 6 o posterior.

Creación de un recurso de Azure

Empiece a usar Bing Spell Check API mediante la creación de uno de los siguientes recursos de Azure:

Recurso de Bing Spell Check

• Disponible a través de Azure Portal hasta que elimine el recurso.
• Use el plan de tarifa gratuito para probar el servicio y actualizarlo más adelante a un nivel de pago para producción.
• Bing Spell Check API también se ofrece en algunos niveles del recurso Bing Search v7.

recurso multiservicio

• Disponible a través de Azure Portal hasta que elimine el recurso.
• Use la misma clave y el mismo punto de conexión para las aplicaciones, en varios servicios de Azure AI.

Creación e inicialización de un proyecto

1. Cree un archivo JavaScript en su IDE o editor favorito. Establezca la severidad y exija https. A continuación, cree variables para el host, la ruta de acceso y la clave de suscripción del punto de conexión de API. Puede usar el punto de conexión global en el código siguiente o usar el punto de conexión de subdominio personalizado que se muestra en Azure Portal para el recurso.

   'use strict';
   let https = require ('https');
   
   let host = 'api.cognitive.microsoft.com';
   let path = '/bing/v7.0/spellcheck';
   let key = '<ENTER-KEY-HERE>';
   

2. Cree variables para los parámetros de búsqueda y el texto que desea comprobar:

   1. Asigne el código de mercado al parámetro mkt con el operador =. El código de mercado es el código del país o región desde el que realiza la solicitud.

   2. Agregue el parámetro mode con el operador & y, a continuación, asigne el modo corrector ortográfico. El modo puede ser proof (detecta la mayoría de los errores ortográficos o gramaticales) o spell (detecta la mayoría de los errores ortográficos, pero no tantos errores gramaticales).

   let mkt = "en-US";
   let mode = "proof";
   let text = "Hollo, wrld!";
   let query_string = "?mkt=" + mkt + "&mode=" + mode;
   

Creación de los parámetros de solicitud

Cree los parámetros de solicitud mediante la creación de un nuevo objeto con un método POST. Añada su ruta agregando su ruta de punto de conexión y su cadena de consulta. A continuación, agregue la clave de suscripción al encabezado Ocp-Apim-Subscription-Key.

let request_params = {
   method : 'POST',
   hostname : host,
   path : path + query_string,
   headers : {
   'Content-Type' : 'application/x-www-form-urlencoded',
   'Content-Length' : text.length + 5,
      'Ocp-Apim-Subscription-Key' : key,
   }
};

Creación de un controlador de respuesta

Cree una función denominada response_handler para tomar la respuesta JSON de la API e imprimirla. Cree una variable para el cuerpo de la respuesta. Añada la respuesta cuando se reciba un indicador de data mediante response.on(). Después de recibir una marca end, imprima el cuerpo JSON en la consola.

let response_handler = function (response) {
    let body = '';
    response.on ('data', function (d) {
        body += d;
    });
    response.on ('end', function () {
        let body_ = JSON.parse (body);
        console.log (body_);
    });
    response.on ('error', function (e) {
        console.log ('Error: ' + e.message);
    });
};

Envío de la solicitud

Llame a la API mediante https.request() con los parámetros de solicitud y el controlador de respuesta. Escriba el texto en la API y, a continuación, finalice la solicitud.

let req = https.request (request_params, response_handler);
req.write ("text=" + text);
req.end ();

Ejecución de la aplicación

1. Compile y ejecute el proyecto.

2. Si usa la línea de comandos, use el siguiente comando para compilar y ejecutar la aplicación:

   node <FILE_NAME>.js
   

Respuesta JSON de ejemplo

Se devuelve una respuesta correcta en JSON, como se muestra en el ejemplo siguiente:

{
   "_type": "SpellCheck",
   "flaggedTokens": [
      {
         "offset": 0,
         "token": "Hollo",
         "type": "UnknownToken",
         "suggestions": [
            {
               "suggestion": "Hello",
               "score": 0.9115257530801
            },
            {
               "suggestion": "Hollow",
               "score": 0.858039839213461
            },
            {
               "suggestion": "Hallo",
               "score": 0.597385084464481
            }
         ]
      },
      {
         "offset": 7,
         "token": "wrld",
         "type": "UnknownToken",
         "suggestions": [
            {
               "suggestion": "world",
               "score": 0.9115257530801
            }
         ]
      }
   ]
}

Pasos siguientes

• ¿Qué es Bing Spell Check API?
• Referencia de Bing Spell Check API v7