Guida introduttiva: Controllare l'ortografia con l'API REST Controllo ortografico Bing e Node.js

Avviso

Il 30 ottobre 2020 le API Ricerca Bing sono state spostate dai servizi di intelligenza artificiale di Azure ai servizi di Ricerca Bing. Questa documentazione viene fornita solo per riferimento. Per la documentazione aggiornata, vedere la documentazione dell'API ricerca Bing. Per istruzioni sulla creazione di nuove risorse di Azure per la ricerca Bing, vedere Creare una risorsa Ricerca Bing tramite il Azure Marketplace.

Usare questa guida introduttiva per effettuare la prima chiamata all'API REST Controllo ortografico Bing. Questa semplice applicazione JavaScript invia una richiesta all'API e restituisce un elenco di correzioni suggerite.

Anche se l'applicazione è scritta in JavaScript, l'API è un servizio Web RESTful compatibile con la maggior parte dei linguaggi di programmazione. Il codice sorgente di questa applicazione è disponibile in GitHub.

Prerequisiti

• Node.js 6 o versione successiva

Creare una risorsa di Azure

Per iniziare a usare l'API Controllo ortografico Bing, creare una delle seguenti risorse di Azure:

Risorsa Controllo ortografico Bing

• disponibile tramite il portale di Azure fino a quando la risorsa non viene eliminata.
• Usare il piano tariffario gratuito per provare il servizio ed eseguire in un secondo momento l'aggiornamento a un livello a pagamento per la produzione.
• L'API Controllo ortografico Bing è disponibile anche in alcuni livelli della risorsa Ricerca Bing v7.

Risorsa multi-servizio

• disponibile tramite il portale di Azure fino a quando la risorsa non viene eliminata.
• Usare la stessa chiave e lo stesso endpoint per le applicazioni in più servizi di intelligenza artificiale di Azure.

Creare e inizializzare un progetto

1. Creare un nuovo file JavaScript nell'ambiente IDE o nell'editor preferito. Impostare la severità e l'uso obbligatorio di https. Creare quindi le variabili per l'host e il percorso dell'endpoint API e per la chiave di sottoscrizione. È possibile usare l'endpoint globale nel codice seguente o l'endpoint del sottodominio personalizzato visualizzato nel portale di Azure per la risorsa.

   'use strict';
   let https = require ('https');
   
   let host = 'api.cognitive.microsoft.com';
   let path = '/bing/v7.0/spellcheck';
   let key = '<ENTER-KEY-HERE>';
   

2. Creare le variabili per i parametri di ricerca e il testo da controllare:

   1. Assegnare il codice di mercato al parametro mkt con l'operatore =. Il codice di mercato è il codice del paese o dell'area geografica da cui si effettua la richiesta.

   2. Aggiungere il parametro mode con l'operatore & e quindi assegnare la modalità di controllo ortografico. La modalità può essere proof (individua la maggior parte degli errori di ortografia/grammatica) o spell (individua la maggior parte degli errori di ortografia, ma meno errori di grammatica).

   let mkt = "en-US";
   let mode = "proof";
   let text = "Hollo, wrld!";
   let query_string = "?mkt=" + mkt + "&mode=" + mode;
   

Creare i parametri della richiesta

Creare i parametri della richiesta creando un nuovo oggetto con un metodo POST. Aggiungere il percorso accodando il percorso dell'endpoint e la stringa di query. Aggiungere quindi la chiave di sottoscrizione all'intestazione Ocp-Apim-Subscription-Key.

let request_params = {
   method : 'POST',
   hostname : host,
   path : path + query_string,
   headers : {
   'Content-Type' : 'application/x-www-form-urlencoded',
   'Content-Length' : text.length + 5,
      'Ocp-Apim-Subscription-Key' : key,
   }
};

Creare un gestore per la risposta

Creare una funzione denominata response_handler per recuperare la risposta JSON dall'API e visualizzarla. Creare una variabile per il corpo della risposta. Aggiungere la risposta quando viene ricevuto un flag data usando response.on(). Dopo la ricezione di un flag end, visualizzare il corpo JSON nella console.

let response_handler = function (response) {
    let body = '';
    response.on ('data', function (d) {
        body += d;
    });
    response.on ('end', function () {
        let body_ = JSON.parse (body);
        console.log (body_);
    });
    response.on ('error', function (e) {
        console.log ('Error: ' + e.message);
    });
};

Inviare la richiesta

Chiamare l'API usando https.request() con i parametri della richiesta e il gestore della risposta. Scrivere il testo nell'API e quindi terminare la richiesta.

let req = https.request (request_params, response_handler);
req.write ("text=" + text);
req.end ();

Eseguire l'applicazione

1. Compilare ed eseguire il progetto.

2. Se si usa la riga di comando, usare il comando seguente per creare ed eseguire l'applicazione:

   node <FILE_NAME>.js
   

Risposta JSON di esempio

Viene restituita una risposta con esito positivo in formato JSON, come illustrato nell'esempio seguente:

{
   "_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
            }
         ]
      }
   ]
}

Passaggi successivi

Creare app Web a pagina singola

• Informazioni sull'API Controllo ortografico Bing
• Informazioni di riferimento per l'API Controllo ortografico Bing v7