Inicio rápido: Revisión ortográfica con la API REST de Bing Spell Check y RubyQuickstart: Check spelling with the Bing Spell Check REST API and Ruby

Use este inicio rápido para realizar la primera llamada a la API REST de Bing Spell Check mediante Ruby.Use this quickstart to make your first call to the Bing Spell Check REST API using Ruby. Esta sencilla aplicación envía una solicitud a la API y devuelve una lista de palabras que no reconoce, seguida de las correcciones sugeridas.This simple application sends a request to the API and returns a list of words it didn't recognize, followed by suggested corrections. Si bien 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.While this application is written in Ruby, the API is a RESTful Web service compatible with most programming languages. El código fuente de esta aplicación está disponible en GitHub.The source code for this application is available on GitHub

Requisitos previosPrerequisites

Debe tener una cuenta de Cognitive Services API con acceso a Bing Spell Check API.You must have a Cognitive Services API account with access to the Bing Spell Check API. Si no tiene una suscripción de Azure, puede crear una cuenta gratuita.If you don't have an Azure subscription, you can create an account for free. Antes de continuar, necesitará la clave de acceso que se le proporcionó al activar la versión de evaluación gratuita o puede usar una clave de suscripción de pago desde el panel de Azure.Before continuing, You will need the access key provided after activating your free trial, or a paid subscription key from your Azure dashboard.

Creación e inicialización de la aplicaciónCreate and initialize the application

  1. Cree un archivo de Ruby en su editor o IDE favoritos y agregue los siguientes requisitos.Create a new Ruby file in your favorite editor or IDE, and add the following requirements.

    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.Create variables for your subscription key, endpoint URI and path. Para crear los parámetros de solicitud, anexe el parámetro mkt= a su mercado y &mode al modo proof.Create your request parameters by appending the mkt= parameter to your market, and &mode to the proof proof mode.

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

Envío de una solicitud de revisión ortográficaSend a spell check request

  1. Cree un URI a partir del URI de host, la ruta de acceso y la cadena de parámetros.Create a URI from your host uri, path, and parameters string. Establezca su consulta para que contenga el texto que quiere revisar.Set its query to contain the text you want to spell check.

    uri = URI(uri + path + params)
    uri.query = URI.encode_www_form({
       # Request parameters
    'text' => 'Hollo, wrld!'
    })
    
  2. Cree una solicitud mediante el URI creado anteriormente.Create a request using the URI constructed above. Agregue su clave al encabezado Ocp-Apim-Subscription-Key.Add your key to the Ocp-Apim-Subscription-Key header.

    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.Send the request.

    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.Get the JSON response, and print it to the console.

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

Ejemplo de respuesta JSONExample JSON response

Se devuelve una respuesta correcta en JSON, como se muestra en el siguiente ejemplo:A successful response is returned in JSON, as shown in the following example:

{
   "_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 siguientesNext steps