Invio di richieste all'API Controllo ortografico Bing
Avviso
Il 30 ottobre 2020 le API di Ricerca Bing spostate dai servizi di intelligenza artificiale di Azure ai servizi Ricerca Bing. Questa documentazione viene fornita solo per informazioni di riferimento. Per la documentazione aggiornata, vedere la documentazione dell'API di ricerca Bing. Per istruzioni sulla creazione di nuove risorse di Azure per la ricerca Bing, vedere Creare una risorsa Ricerca Bing tramite la Azure Marketplace.
Per controllare gli errori di ortografia e grammatica di una stringa di testo è consigliabile inviare una richiesta GET all'endpoint seguente:
https://api.cognitive.microsoft.com/bing/v7.0/spellcheck
La richiesta deve usare il protocollo HTTPS.
È consigliabile che tutte le richieste abbiano origine da un server. La distribuzione della chiave come parte di un'applicazione client consente a terze parti dannose di accedervi più facilmente. Un server fornisce anche un singolo punto di aggiornamento per le future versioni dell'API.
La richiesta deve specificare il parametro di query text, contenente la stringa di testo da controllare. Nonostante sia facoltativo, la richiesta dovrebbe anche specificare il parametro di query mkt, che identifica il mercato da cui devono provenire i risultati. Per un elenco di parametri di query facoltativi come mode, vedere Query Parameters (Parametri di query). Tutti i valori dei parametri di query devono essere codificati in URL.
La richiesta deve specificare l'intestazione Ocp-Apim-Subscription-Key. Nonostante sia facoltativo, è consigliabile specificare anche le intestazioni seguenti. Queste intestazioni consentono all'API Controllo ortografico Bing di restituire risultati più accurati.
Per un elenco di tutte le intestazioni di richiesta e risposta, vedere Headers (Intestazioni).
Quando si chiama l'API Controllo ortografico Bing tramite JavaScript, le funzionalità di sicurezza predefinite del browser potrebbero impedire l'accesso ai valori di queste intestazioni.
Per risolvere il problema, è possibile inviare la richiesta all'API Controllo ortografico Bing tramite un proxy CORS. La risposta di tale proxy ha un'intestazione Access-Control-Expose-Headers che filtra le intestazioni di risposta e le rende disponibili per JavaScript.
Si può installare facilmente un proxy CORS per consentire all'app dell'esercitazione di accedere alle intestazioni client facoltative. Per prima cosa installare Node.js, se non è già disponibile. Immettere quindi il comando seguente al prompt dei comandi.
npm install -g cors-proxy-server
Modificare quindi l'endpoint dell'API Controllo ortografico Bing nel file HTML come segue:
http://localhost:9090/https://api.cognitive.microsoft.com/bing/v7.0/spellcheck/
Infine avviare il proxy CORS con il comando seguente:
cors-proxy-server
Lasciare aperta la finestra di comando mentre si usa l'app dell'esercitazione. La chiusura della finestra determina l'arresto del proxy. Nella sezione espandibile delle intestazioni HTTP sotto i risultati della ricerca viene ora visualizzata, tra le altre, l'intestazione X-MSEdge-ClientID. Verificare che sia la stessa per ogni richiesta.
Richiesta API di esempio
Di seguito è illustrata una richiesta che include tutte le intestazioni e i parametri di query suggeriti. Se è la prima volta che si chiama un'API Bing, non includere l'intestazione dell'ID client. Includere l'ID client solo se in precedenza è già stata chiamata un'API Bing e Bing ha restituito un ID client per la combinazione utente e dispositivo.
GET https://api.cognitive.microsoft.com/bing/v7.0/spellcheck?text=when+its+your+turn+turn,+john,+come+runing&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
X-MSEdge-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com
Di seguito è riportata la risposta alla richiesta precedente. L'esempio mostra anche le intestazioni di risposta specifiche di Bing.
Nota
Poiché i formati e i parametri degli URL sono soggetti a modifica senza preavviso, usare gli URL così come sono. Non acquisire dipendenze da formati o parametri degli URL se non diversamente specificato.
BingAPIs-TraceId: 76DD2C2549B94F9FB55B4BD6FEB6AC
X-MSEdge-ClientID: 1C3352B306E669780D58D607B96869
BingAPIs-Market: en-US
{
"_type" : "SpellCheck",
"flaggedTokens" : [{
"offset" : 5,
"token" : "its",
"type" : "UnknownToken",
"suggestions" : [{
"suggestion" : "it's",
"score" : 1
}]
},
{
"offset" : 25,
"token" : "john",
"type" : "UnknownToken",
"suggestions" : [{
"suggestion" : "John",
"score" : 1
}]
},
{
"offset" : 19,
"token" : "turn",
"type" : "RepeatedToken",
"suggestions" : [{
"suggestion" : "",
"score" : 1
}]
},
{
"offset" : 35,
"token" : "runing",
"type" : "UnknownToken",
"suggestions" : [{
"suggestion" : "running",
"score" : 1
}]
}]
}