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

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 PHP-Anwendung sendet eine Anforderung an die API und gibt eine Liste mit Korrekturvorschlägen zurück.This simple PHP application sends a request to the API and returns a list of suggested corrections. Diese Anwendung ist zwar in PHP geschrieben, an sich ist die API aber ein RESTful-Webdienst, der mit den meisten Programmiersprachen kompatibel ist.While this application is written in PHP, the API is a RESTful Web service compatible with most programming languages.

VoraussetzungenPrerequisites

Erstellen einer Azure-RessourceCreate an Azure resource

Beginnen Sie mit der Verwendung der Rechtschreibprüfung-API, indem Sie eine der unten aufgeführten Azure-Ressourcen erstellen.Start using the Bing Spell Check API by creating one of the Azure resources below.

  • Erstellen einer Testressource:Create a trial resource:

    • Kein Azure-Abonnement erforderlich.No Azure subscription needed.
    • Kostenlos und sieben Tage lang gültig.Valid for seven days, for free. Nach der Registrierung stehen ein Testschlüssel und ein Endpunkt auf der Azure-Website zur Verfügung.After signing up, a trial key and endpoint will be available on the Azure website.
  • Erstellen Sie eine Bing-Rechtschreibprüfung-Ressource:Create a Bing Spell Check resource:

    • Verfügbar über das Azure-Portal, bis Sie die Ressource löschen.Available through the Azure portal until you delete the resource.
    • Verwenden Sie den Tarif „Free“, um den Dienst zu testen, und führen Sie später für die Produktion ein Upgrade auf einen kostenpflichtigen Tarif durch.Use the free pricing tier to try the service, and upgrade later to a paid tier for production.
    • Die Bing-Rechtschreibprüfung-API wird auch in einigen Tarifen der Bing-Suche v7-Ressource angeboten.Bing Spell Check API is also offered in some tiers of the Bing Search v7 resource.
  • Erstellen einer Ressource für mehrere Dienste:Create a Multi-Service resource:

    • Verfügbar über das Azure-Portal, bis Sie die Ressource löschen.Available through the Azure portal until you delete the resource.
    • Verwenden Sie für Ihre Anwendungen den gleichen Schlüssel und Endpunkt über mehrere Cognitive Services-Instanzen hinweg.Use the same key and endpoint for your applications, across multiple Cognitive Services.

Abrufen der Ergebnisse der RechtschreibprüfungGet Spell Check results

  1. Erstellen Sie in Ihrer bevorzugten IDE ein neues PHP-Projekt.Create a new PHP project in your favorite IDE.

  2. Fügen Sie den unten stehenden Code hinzu.Add the code provided below.

  3. Ersetzen Sie den subscriptionKey-Wert durch einen für Ihr Abonnement gültigen Zugriffsschlüssel.Replace the subscriptionKey value with an access key valid for your subscription.

  4. Sie können den unten angegebenen globalen Endpunkt oder den Endpunkt der benutzerdefinierten Unterdomäne verwenden, der im Azure-Portal für Ihre Ressource angezeigt wird.You can use the global endpoint below, or the custom subdomain endpoint displayed in the Azure portal for your resource.

  5. Führen Sie das Programm aus.Run the program.

    <?php
    
    // NOTE: Be sure to uncomment the following line in your php.ini file.
    // ;extension=php_openssl.dll
    
    // These properties are used for optional headers (see below).
    // define("CLIENT_ID", "<Client ID from Previous Response Goes Here>");
    // define("CLIENT_IP", "999.999.999.999");
    // define("CLIENT_LOCATION", "+90.0000000000000;long: 00.0000000000000;re:100.000000000000");
    
    $host = 'https://api.cognitive.microsoft.com';
    $path = '/bing/v7.0/spellcheck?';
    $params = 'mkt=en-us&mode=proof';
    
    $input = "Hollo, wrld!";
    
    $data = array (
        'text' => urlencode ($input)
    );
    
    // NOTE: Replace this example key with a valid subscription key.
    $key = 'ENTER KEY HERE';
    
    // The following headers are optional, but it is recommended
    // that they are treated as required. These headers will assist the service
    // with returning more accurate results.
    //'X-Search-Location' => CLIENT_LOCATION
    //'X-MSEdge-ClientID' => CLIENT_ID
    //'X-MSEdge-ClientIP' => CLIENT_IP
    
    $headers = "Content-type: application/x-www-form-urlencoded\r\n" .
        "Ocp-Apim-Subscription-Key: $key\r\n";
    
    // NOTE: Use the key 'http' even if you are making an HTTPS request. See:
    // https://php.net/manual/en/function.stream-context-create.php
    $options = array (
        'http' => array (
            'header' => $headers,
            'method' => 'POST',
            'content' => http_build_query ($data)
        )
    );
    $context  = stream_context_create ($options);
    $result = file_get_contents ($host . $path . $params, false, $context);
    
    if ($result === FALSE) {
        /* Handle error */
    }
    
    $json = json_encode(json_decode($result), JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
    echo $json;
    ?>
    

Ausführen der AnwendungRun the application

Führen Sie die Anwendung aus, indem Sie einen Webserver starten und zu Ihrer Datei navigieren.Run your application by starting a web server and navigating to your file.

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