Hızlı Başlangıç: Bing Yazım Denetimi REST API'siyle ve Python ile yazım denetimi yapma

Makale
05/21/2020

Uyarı

30 Ekim 2020'de Bing Arama API'leri Azure yapay zeka hizmetlerinden Bing Arama Hizmetlerine taşındı. Bu belgeler yalnızca başvuru için sağlanır. Güncelleştirilmiş belgeler için Bing arama API'sinin belgelerine bakın. Bing araması için yeni Azure kaynakları oluşturma yönergeleri için bkz. Azure Market aracılığıyla Bing Arama kaynağı oluşturma.

Bing Yazım Denetimi REST API'sine ilk çağrınızı yapmak için bu hızlı başlangıcı kullanın. Bu basit Python uygulaması API'ye bir istek gönderir ve önerilen düzeltmelerin listesini döndürür.

Bu uygulama Python'da yazılmış olsa da, API çoğu programlama diliyle uyumlu bir RESTful Web hizmetidir. Bu uygulamanın kaynak kodu GitHub'da kullanılabilir

Önkoşullar

Python 3.x

Azure kaynağı oluşturma

Aşağıdaki Azure kaynaklarından birini oluşturarak Bing Yazım Denetimi API'sini kullanmaya başlayın:

Bing Yazım Denetimi kaynağı

Kaynağı silene kadar Azure portal aracılığıyla kullanılabilir.
Hizmeti denemek için ücretsiz fiyatlandırma katmanını kullanın ve daha sonra üretim için ücretli bir katmana yükseltin.
Bing Yazım Denetimi API'si, Bing Arama v7 kaynağının bazı katmanlarında da sunulur.

Çok hizmetli kaynak

Kaynağı silene kadar Azure portal aracılığıyla kullanılabilir.
Birden çok Azure AI hizmeti genelinde uygulamalarınız için aynı anahtarı ve uç noktayı kullanın.

Uygulamayı başlatma

Sık kullandığınız IDE veya düzenleyicide yeni bir Python dosyası oluşturun ve aşağıdaki içeri aktarma deyimlerini ekleyin:
```
import requests
import json
```
Yazım denetimi yapmak istediğiniz metin, abonelik anahtarınız ve Bing Yazım Denetimi uç noktanız için değişkenler oluşturun. Aşağıdaki kodda genel uç noktayı kullanabilir veya kaynağınız için Azure portal görüntülenen özel alt etki alanı uç noktasını kullanabilirsiniz.
```
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"
```

İstek için parametreleri oluşturma

Anahtar olarak ve metninizi değer olarak içeren text yeni bir sözlük oluşturun.
```
data = {'text': example_text}
```
İsteğiniz için parametreleri ekleyin:
1. Market kodunuzu mkt işleciyle parametresine atayın = . Pazar kodu, isteği yaptığınız ülkenin/bölgenin kodudur.
2. parametresini mode işleciyle & ekleyin ve yazım denetimi modunu atayın. Mod ( yazım/dil bilgisi hatalarının çoğunu yakalar) veya spell (çoğu yazım hatasını yakalar, ancak çok fazla dil bilgisi hatası yakalamaz) olabilir proof .
```
params = {
    'mkt':'en-us',
    'mode':'proof'
    }
```

Üst bilginize bir Content-Type üst bilgi ve abonelik anahtarı Ocp-Apim-Subscription-Key ekleyin.

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

İsteği gönderme ve yanıtı okuma

İstek kitaplığını kullanarak POST isteğini gönderin.

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

JSON yanıtını alın ve yazdırın.

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

Uygulamayı çalıştırma

Komut satırını kullanıyorsanız, uygulamayı çalıştırmak için aşağıdaki komutu kullanın:

python <FILE_NAME>.py

Örnek JSON yanıtı

Başarılı yanıt, aşağıdaki örnekte gösterildiği gibi JSON biçiminde döndürülür:

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

Sonraki adımlar

Tek sayfalı web uygulaması oluşturma

Aracılığıyla paylaş