Inicio rápido: Revisión ortográfica con bing Spell Check REST API y Ruby

Advertencia

El 30 de octubre de 2020, las API de Bing Search se trasladaron de los servicios de Azure AI a Bing Search Services. Esta documentación solo se proporciona como referencia. Para obtener documentación actualizada, consulte la documentación de la API de búsqueda de Bing . Para obtener instrucciones sobre cómo crear nuevos recursos de Azure para la búsqueda de Bing, consulte Creación de un recurso de Bing Search a través de Azure Marketplace.

Use este inicio rápido para realizar la primera llamada a bing Spell Check REST API mediante Ruby. Esta aplicación sencilla envía una solicitud a la API y devuelve una lista de correcciones sugeridas.

Aunque esta aplicación está escrita en Ruby, 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

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 la aplicación

  1. Cree un archivo ruby en su editor o IDE favorito y agregue los siguientes requisitos:

    require 'net/http'
require 'uri'
require 'json'

  2. Cree variables para la clave de suscripción, el URI del punto de conexión y la ruta de acceso. 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. Cree los parámetros de solicitud:

    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).

    key = 'ENTER YOUR KEY HERE'
uri = 'https://api.cognitive.microsoft.com'
path = '/bing/v7.0/spellcheck?'
params = 'mkt=en-us&mode=proof'

Enviar una solicitud de revisión ortográfica

  1. Cree un URI a partir del URI de su host, su ruta de acceso y su cadena de parámetros. Establezca su consulta para que contenga el texto que desea revisar ortográficamente.

    uri = URI(uri + path + params)
uri.query = URI.encode_www_form({
   # Request parameters
'text' => 'Hollo, wrld!'
})

  2. Cree una solicitud con el URI construido anteriormente. Agregue su clave en el encabezado Ocp-Apim-Subscription-Key.

    request = Net::HTTP::Post.new(uri)
request['Content-Type'] = "application/x-www-form-urlencoded"
request['Ocp-Apim-Subscription-Key'] = key

  3. Envíe la solicitud.

    response = Net::HTTP.start(uri.host, uri.port, :use_ssl => uri.scheme == 'https') do |http|
    http.request(request)
end

  4. Obtenga la respuesta JSON e imprímala en la consola.

    result = JSON.pretty_generate(JSON.parse(response.body))
puts result

Ejecución de la aplicación

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

ruby <FILE_NAME>.rb

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

Crear una aplicación web de página única

  • Last updated on