Mulai cepat: Periksa ejaan dengan REST API Pemeriksa Ejaan Bing dan Python

Artikel
05/21/2020

Peringatan

Pada 30 Oktober 2020, API Bing Search dipindahkan dari layanan Azure AI ke layanan Bing Search. Dokumentasi ini disediakan hanya untuk referensi. Untuk dokumentasi terbaru, lihat dokumentasi Bing Search API. Untuk petunjuk tentang cara membuat sumber daya Azure baru untuk pencarian Bing, lihat Membuat sumber daya Pencarian Bing melalui Marketplace Azure.

Gunakan mulai cepat ini untuk melakukan panggilan pertama Anda ke Bing Spell Check REST API. Aplikasi Python sederhana ini mengirimkan permintaan ke API dan mengembalikan daftar koreksi yang disarankan.

Meskipun aplikasi ini ditulis dengan Python, API adalah layanan Web RESTful yang kompatibel dengan sebagian besar bahasa pemrograman. Kode sumber untuk aplikasi ini tersedia di GitHub

Prasyarat

Python 3.x

Membuat grup sumber daya Azure

Mulai gunakan Bing Spell Check API dengan membuat salah satu sumber daya Azure berikut:

Sumber daya Bing Spell Check

Tersedia melalui portal Azure hingga Anda menghapus sumber daya.
Gunakan tingkat harga gratis untuk mencoba layanan, dan tingkatkan ke tingkat berbayar untuk produksi di kemudian hari.
Bing Spell Check API juga ditawarkan di beberapa tingkatan sumber daya Bing Search v7.

Sumber daya multilayanan

Tersedia melalui portal Microsoft Azure hingga Anda menghapus sumber daya.
Gunakan kunci dan titik akhir yang sama untuk aplikasi Anda, di beberapa layanan Azure AI.

Menginisialisasi aplikasi

Buat file Python baru di IDE atau editor favorit Anda, dan tambahkan pernyataan impor berikut:
```
import requests
import json
```
Buat variabel untuk teks yang ingin Anda periksa ejaannya, kunci langganan Anda, dan titik akhir Pemeriksa Ejaan Bing Anda. Anda dapat menggunakan titik akhir global dalam kode berikut, atau menggunakan titik akhir subdomain kustom yang ditampilkan di portal Azure untuk sumber daya Anda.
```
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"
```

Membuat parameter untuk permintaan

Buat kamus baru dengan text sebagai kunci, dan teks Anda sebagai nilai.
```
data = {'text': example_text}
```
Tambahkan parameter untuk permintaan Anda:
1. Tetapkan kode pasar Anda ke parameter mkt dengan operator =. Kode pasar adalah kode negara/wilayah tempat Anda mengajukan permintaan.
2. Tambahkan parameter mode dengan operator &, lalu tetapkan mode pemeriksa ejaan. Mode dapat berupa proof (menangkap sebagian besar kesalahan ejaan/tata bahasa) atau spell (menangkap sebagian besar kesalahan ejaan, tetapi tidak sebanyak kesalahan tata bahasa).
```
params = {
    'mkt':'en-us',
    'mode':'proof'
    }
```

Tambahkan header Content-Type dan kunci langganan Anda ke header Ocp-Apim-Subscription-Key.

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

Kirim permintaan dan baca respons

Kirim permintaan POST dengan menggunakan pustaka permintaan.

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

Dapatkan respons JSON dan cetak.

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

Menjalankan aplikasi

Jika Anda menggunakan baris perintah, gunakan perintah berikut untuk menjalankan aplikasi:

python <FILE_NAME>.py

Contoh respons JSON

Respons yang berhasil dikembalikan di JSON, seperti yang diperlihatkan dalam contoh berikut:

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

Langkah berikutnya

Membuat aplikasi web satu halaman

Bagikan melalui