Mulai Cepat: Memeriksa ejaan dengan Bing Spell Check REST API dan Node.js

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 JavaScript sederhana ini mengirimkan permintaan ke API dan mengembalikan daftar koreksi yang disarankan.

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

Prasyarat

Node.js 6 atau yang lebih baru.

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.

Membuat dan menginisialisasi proyek

Buat file JavaScript baru di IDE atau editor favorit Anda. Atur keketatannya, dan minta https. Kemudian, buat variabel untuk kunci langganan, jalur, dan host titik akhir API 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.
```
'use strict';
let https = require ('https');

let host = 'api.cognitive.microsoft.com';
let path = '/bing/v7.0/spellcheck';
let key = '<ENTER-KEY-HERE>';
```
Buat variabel untuk parameter pencarian Anda dan teks yang ingin Anda periksa:
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).
```
let mkt = "en-US";
let mode = "proof";
let text = "Hollo, wrld!";
let query_string = "?mkt=" + mkt + "&mode=" + mode;
```

Membuat parameter permintaan

Buat parameter permintaan Anda dengan membuat objek baru dengan metode POST. Tambahkan jalur Anda dengan menambahkan jalur titik akhir, dan string kueri. Lalu, tambahkan kunci langganan Anda ke header 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,
   }
};

Membuat pengatur respons

Buat fungsi bernama response_handler untuk mengambil respons JSON dari API, dan mencetaknya. Buat variabel untuk isi respons. Tambahkan respons saat bendera data diterima dengan menggunakan response.on(). Setelah bendera end diterima, cetak isi JSON ke konsol.

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);
    });
};

Mengirim permintaan

Panggil API menggunakan https.request() dengan parameter permintaan dan pengatur respons Anda. Tulis teks Anda ke API, lalu akhiri permintaan.

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

Menjalankan aplikasi

Membangun dan menjalankan proyek Anda.
Jika Anda menggunakan baris perintah, gunakan perintah berikut untuk membangun dan menjalankan aplikasi:
```
node <FILE_NAME>.js
```

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