Schnellstart: Überprüfen der Rechtschreibung mit der Bing-Rechtschreibprüfungs-REST-API und RubyQuickstart: Check spelling with the Bing Spell Check REST API and Ruby

In dieser Schnellstartanleitung erfahren Sie, wie Sie die Bing-Rechtschreibprüfungs-REST-API unter Verwendung von Ruby zum ersten Mal aufrufen.Use this quickstart to make your first call to the Bing Spell Check REST API using Ruby. Diese einfache Anwendung sendet eine Anforderung an die API und gibt eine Liste mit nicht erkannten Wörtern sowie entsprechende Korrekturvorschläge zurück.This simple application sends a request to the API and returns a list of words it didn't recognize, followed by suggested corrections. Diese Anwendung ist zwar in Ruby geschrieben, an sich ist die API aber ein RESTful-Webdienst, der mit den meisten Programmiersprachen kompatibel ist.While this application is written in Ruby, the API is a RESTful Web service compatible with most programming languages. Der Quellcode für diese Anwendung ist auf GitHub verfügbar.The source code for this application is available on GitHub

VoraussetzungenPrerequisites

Sie benötigen ein Cognitive Services-API-Konto mit Zugriff auf die Bing-Rechtschreibprüfungs-API.You must have a Cognitive Services API account with access to the Bing Spell Check API. Falls Sie nicht über ein Azure-Abonnement verfügen, können Sie ein kostenloses Konto erstellen.If you don't have an Azure subscription, you can create an account for free. Vor dem Fortfahren benötigen Sie den Zugriffsschlüssel, der nach dem Aktivieren Ihrer kostenlosen Testversion bereitgestellt wird. Alternativ hierzu können Sie auch den Schlüssel eines kostenpflichtigen Abonnements aus Ihrem Azure-Dashboard verwenden.Before continuing, You will need the access key provided after activating your free trial, or a paid subscription key from your Azure dashboard.

Erstellen und Initialisieren der AnwendungCreate and initialize the application

  1. Erstellen Sie in Ihrem bevorzugten Editor oder in Ihrer bevorzugten IDE eine neue Ruby-Datei, und fügen Sie die folgenden Anforderungen hinzu.Create a new Ruby file in your favorite editor or IDE, and add the following requirements.

    require 'net/http'
    require 'uri'
    require 'json'
    
  2. Erstellen Sie Variablen für Ihren Abonnementschlüssel, Endpunkt-URI und Pfad.Create variables for your subscription key, endpoint URI and path. Erstellen Sie Ihre Anforderungsparameter, indem Sie den Parameter mkt= an Ihren Markt und &mode an den Prüfmodus proof anfügen.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'
    

Senden einer RechtschreibprüfungsanforderungSend a spell check request

  1. Erstellen Sie einen URI auf der Grundlage Ihres Host-URIs, Ihres Pfads und Ihrer Parameterzeichenfolge.Create a URI from your host uri, path, and parameters string. Legen Sie die zugehörige Abfrage so fest, dass sie den Text enthält, für den die Rechtschreibprüfung durchgeführt werden soll.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. Erstellen Sie eine Anforderung mit dem oben erstellten URI.Create a request using the URI constructed above. Fügen Sie Ihren Schlüssel dem Header Ocp-Apim-Subscription-Key hinzu.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. Senden Sie die Anforderung.Send the request.

    response = Net::HTTP.start(uri.host, uri.port, :use_ssl => uri.scheme == 'https') do |http|
        http.request(request)
    end
    
  4. Rufen Sie die JSON-Antwort ab, und geben Sie sie in der Konsole aus.Get the JSON response, and print it to the console.

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

JSON-BeispielantwortExample JSON response

Es wird eine erfolgreiche Antwort im JSON-Format zurückgegeben, wie im folgenden Beispiel gezeigt: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
            }
         ]
      }
   ]
}

Nächste SchritteNext steps