Bing API 提供了一組可讓開發者整合搜尋能力的介面。透過 jQuery 的 AJAX 功能,我們可以在自己的網站中建構一個簡易搜尋頁面,讓使用者輸入關鍵字後,直接在頁面上看到搜尋結果。
Bing API 支援多種回傳格式,包括 SOAP、XML 與 JSON。在前端整合時,JSON 或 JSONP 通常比較方便,因為它能被 JavaScript 直接處理,也適合跨域請求情境。
使用前需要先到 Bing 開發者網站申請 App ID。這個識別碼會在呼叫 API 時帶入,用來標示請求來源。接著可以規劃搜尋參數,例如查詢詞、來源類型、版本、地區、每頁筆數與起始頁碼等。
搜尋頁面通常包含幾個區塊:輸入框與搜尋按鈕、結果標題、結果統計、結果列表、錯誤訊息與翻頁導航。這些元素可以先在 HTML 中建立好,再由 jQuery 動態填入內容。
當使用者點擊搜尋按鈕時,可以收集輸入框中的關鍵字,把參數組成查詢字串,然後用 jQuery 的 AJAX 方法發出請求。若使用 JSONP,需要指定資料類型為 jsonp,並提供回呼函式名稱。
成功取得資料後,可以先檢查回應中的錯誤物件。若沒有錯誤,就把結果列表清空,再逐筆產生搜尋項目,包含標題、連結、描述與網址。若開啟了關鍵字高亮,也可以把 API 回傳的高亮標記轉成粗體樣式。
最後可根據總筆數與目前頁碼建立上一頁、下一頁或頁碼導航。透過這種方式,一個簡易但完整的搜尋體驗就完成了。