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

Verwenden Sie diese Schnellstartanleitung, um die Bing-Rechtschreibprüfungs-REST-API zum ersten Mal aufzurufen.Use this quickstart to make your first call to the Bing Spell Check REST API. Diese einfache Python-Anwendung sendet eine Anforderung an die API und gibt eine Liste mit Korrekturvorschlägen zurück.This simple Python application sends a request to the API and returns a list of suggested corrections. Diese Anwendung ist zwar in Python geschrieben, an sich ist die API aber ein RESTful-Webdienst, der mit den meisten Programmiersprachen kompatibel ist.While this application is written in Python, 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.

Initialisieren der AnwendungInitialize the application

  1. Erstellen Sie in Ihrer bevorzugten IDE bzw. in einem Editor eine neue Python-Datei, und fügen Sie die folgende Importanweisung hinzu.Create a new Python file in your favorite IDE or editor, and add the following import statement.

    import requests
    import json
    
  2. Erstellen Sie Variablen für den Text, für den eine Rechtschreibprüfung ausgeführt werden soll, sowie für Ihren Abonnementschlüssel und Ihren Endpunkt für die Bing-Rechtschreibprüfung.Create variables for the text you want to spell check, your subscription key, and your Bing Spell Check endpoint.

    api_key = "<ENTER-KEY-HERE>"
    example_text = "Hollo, wrld" # the text to be spell-checked
    endpoint = "https://api.cognitive.microsoft.com/bing/v7.0/SpellCheck"
    

Erstellen der Parameter für die AnforderungCreate the parameters for the request

  1. Erstellen Sie ein neues Wörterbuch mit text als Schlüssel und Ihrem Text als Wert.Create a new dictionary with text as the key, and your text as the value.

    data = {'text': example_text}
    
  2. Fügen Sie die Parameter für Ihre Anforderung hinzu.Add the parameters for your request. Fügen Sie Ihren Marktcode nach mkt= an.Append your market code after mkt=. Der Marktcode ist das Land, aus dem Sie die Anforderung stellen.The market code is the country you make the request from. Fügen Sie außerdem Ihren Modus für die Rechtschreibprüfung nach &mode= an.Also, append your spell-check mode after &mode=. Der Modus ist entweder proof (fängt die meisten Rechtschreib-/Grammatikfehler ab) oder spell (fängt die meisten Rechtschreib-, aber nicht so viele Grammatikfehler ab).Mode is either proof (catches most spelling/grammar errors) or spell (catches most spelling but not as many grammar errors).

    params = {
        'mkt':'en-us',
        'mode':'proof'
        }
    
  3. Fügen Sie einen Header vom Typ Content-Type und dem Header Ocp-Apim-Subscription-Key Ihren Abonnementschlüssel hinzu.Add a Content-Type header, and your subscription key to the Ocp-Apim-Subscription-Key header.

    headers = {
        'Content-Type': 'application/x-www-form-urlencoded',
        'Ocp-Apim-Subscription-Key': api_key,
        }
    

Senden der Anforderung und Lesen der AntwortSend the request and read the response

  1. Senden Sie die POST-Anforderung unter Verwendung der Anforderungsbibliothek.Send the POST request using the requests library.

    response = requests.post(endpoint, headers=headers, params=params, data=data)
    
  2. Rufen Sie die JSON-Antwort ab, und geben Sie sie aus.Get the JSON response, and print it.

    json_response = response.json()
    print(json.dumps(json_response, indent=4))
    

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