封面照片由 Christopher Gower 在 Unsplash 上拍攝

您是否正在開發語言學習應用程式、寫作助理或任何涉及單字並需要 API 來檢索單字意義的項目？免費字典 API 提供了一種免費且易於存取的方式，將語言資料合併到您的作品中。本文檔將向您展示如何開始。

在此 API 文件中：

• 關於免費字典API
• 端點
• 範例
• 其他資源

關於免費字典 API：

由 meetDeveloper 開發的免費字典 API，在 GitHub 上擁有 2,600 顆星。 API 僅支援 GET 請求，並提供單字定義和音標。

主要特點：

• 免費使用
• 無使用限制
• 無授權或 API 金鑰

端點

https://api.dictionaryapi.dev/api/v2/entries/en/

• 此端點檢索指定英文單字的字典資訊。

• API有兩個版本：v1和v2。主要區別在於響應結構。目前版本是 v2。

查詢參數

• word（字串，必填）：要找的單字。

回應格式

API傳回一個JSON數組，其中包含單個對象，其中包含有關單字的詳細信息，包括：

如果請求成功：

• word(string): 查詢的字
• voicetic(string): 字的音標
• voicetics(array): 語音物件數組，每個物件包含：
• text(string): 音標
• 音訊（字串）：音訊發音的 URL（可為空）
• 意義（陣列）：表示意義的物件陣列
• partOfSpeech（字串）：詞性（如名詞、動詞）
• 定義（數組）：定義物件的數組，每個物件包含：
• 定義（字串）：單字的定義
• synonyms(array): 同義詞數組
• antonyms (array): 反義詞陣列
• 許可證（對象）：有關提供資料的許可證的資訊
• sourceUrls (array): 資料來源的 URL 陣列

如果請求不成功：

• title（字串）：一則訊息，指示未找到單字
的定義
• message（字串）：未找到該單字的定義的訊息
• 解決方案（字串）：建議再次使用搜尋或網路。

範例：

請求範例 1（成功）：

const word = "documentation";
fetch(`https://api.dictionaryapi.dev/api/v2/entries/en/${word}`)
  .then(response => response.json())
  .then(data => console.log(data));

回應範例 1：

[
  {
    "word": "documentation",
    "phonetic": "/ˌdɒkjʊmənˈteɪʃən/",
    "phonetics": [
      {
        "text": "/ˌdɒkjʊmənˈteɪʃən/",
        "audio": ""
      },
      {
        "text": "/ˌdɑkjəmənˈteɪʃən/",
        "audio": ""
      }
    ],
    "meanings": [
      {
        "partOfSpeech": "noun",
        "definitions": [
          {
            "definition": "Something transposed from a thought to a document; the written account of an idea.",
            "synonyms": [],
            "antonyms": []
          },
          {
            "definition": "Documentary evidence and sources.",
            "synonyms": [],
            "antonyms": []
          },
          {
            "definition": "Documents that explain the operation of a particular machine or software program.",
            "synonyms": [],
            "antonyms": []
          },
          {
            "definition": "Comments that explain the usage of individual functions, libraries and blocks of code.",
            "synonyms": [],
            "antonyms": []
          }
        ],
        "synonyms": [],
        "antonyms": []
      }
    ],
    "license": {
      "name": "CC BY-SA 3.0",
      "url": "https://creativecommons.org/licenses/by-sa/3.0"
    },
    "sourceUrls": [
      "https://en.wiktionary.org/wiki/documentation"
    ]
  }
]

請求範例 2：

const word = "Software engineer";
fetch(`https://api.dictionaryapi.dev/api/v2/entries/en/${word}`)
  .then(response => response.json())
  .then(data => console.log(data));

回應範例 2（未成功）：

{
  "title": "No Definitions Found",
  "message": "Sorry pal, we couldn't find definitions for the word you were looking for.",
  "resolution": "You can try the search again at later time or head to the web instead."
}

成功和錯誤代碼

該API目前不回傳特定的成功或錯誤代碼。

其他資源

要嘗試該 API 或支援 Free Dictionary API，請造訪 Free Dictionary API 網站。

另請參閱 Github 上的免費字典 API 專案。