Démarrage rapide : Vérifier l’orthographe avec l’API REST Vérification orthographique Bing et Python

Article
05/21/2020

Avertissement

Le 30 octobre 2020, les API de recherche Bing sont passées des services Azure AI aux services de recherche Bing. Cette documentation est fournie uniquement pour référence. Pour accéder à la documentation mise à jour, consultez la documentation de l’API Recherche Bing. Pour obtenir des instructions sur la création de nouvelles ressources Azure pour Recherche Bing, consultez Créer une ressource Recherche Bing à l’aide de Place de marché Azure.

Utilisez ce guide de démarrage rapide pour effectuer votre premier appel à l’API REST Vérification orthographique Bing. Cette application Python simple envoie une requête à l’API et retourne une liste de corrections suggérées.

Bien que cette application soit écrite en Python, l’API est un service web RESTful compatible avec la plupart des langages de programmation. Le code source de cette application est disponible sur GitHub

Conditions préalables

Python 3.x

Créer une ressource Azure

Commencez à utiliser l’API Vérification orthographique Bing en créant l’une des ressources Azure suivantes :

la ressource de vérification orthographique de Bing

Disponible via le portail Azure jusqu’à ce que vous supprimiez la ressource.
Utilisez le niveau tarifaire gratuit pour essayer le service, puis effectuez une mise à niveau ultérieure vers un niveau payant pour la production.
L’API Vérification orthographique Bing est également proposée dans certains niveaux de la ressource Recherche Bing v7.

Ressource multiservice

Disponible via le portail Azure jusqu’à ce que vous supprimiez la ressource.
Utilisez la même clé et le même point de terminaison pour vos applications, sur plusieurs services Azure AI.

Initialiser l’application

Créez un fichier Python dans votre IDE ou éditeur favori, puis ajoutez les instructions d’importation suivantes :
```
import requests
import json
```
Créez des variables pour le texte dont vous souhaitez vérifier l'orthographe, votre clé d’abonnement et le point de terminaison de la vérification orthographique Bing. Vous pouvez utiliser le point de terminaison global dans le code suivant ou utiliser le sous-domaine personnalisé point de terminaison affiché dans le portail Azure pour votre ressource.
```
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"
```

Créer les paramètres de la requête

Créez un dictionnaire avec text comme clé et votre texte comme valeur.
```
data = {'text': example_text}
```
Ajoutez les paramètres de votre demande :
1. Affectez votre code de marché au paramètre mkt avec l’opérateur =. Le code de marché est le code du pays/de la région à partir duquel vous effectuez la demande.
2. Ajoutez le paramètre mode avec l’opérateur &, puis attribuez le mode de vérification orthographique. Le mode peut être proof (intercepte la plupart des erreurs d’orthographe/grammaire) ou spell (intercepte la plupart des erreurs d’orthographe, mais pas autant d’erreurs de grammaire).
```
params = {
    'mkt':'en-us',
    'mode':'proof'
    }
```

Ajoutez un en-tête Content-Type et votre clé d’abonnement à l’en-tête Ocp-Apim-Subscription-Key.

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

Envoyer la demande et lire la réponse

Envoyez la requête POST à l’aide de la bibliothèque de requêtes.

response = requests.post(endpoint, headers=headers, params=params, data=data)

Obtenez la réponse JSON et imprimez-la.

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

Exécuter l’application

Si vous utilisez la ligne de commande, utilisez la commande suivante pour exécuter l’application :

python <FILE_NAME>.py

Exemple de réponse JSON

Une réponse réussie est retournée dans JSON, comme illustré dans l’exemple suivant :

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

Étapes suivantes

Créer une application web monopage

Partager via