Christopher Gower による Unsplash のカバー写真

言語学習アプリ、ライティングアシスタント、または単語に関係するプロジェクトを開発していて、単語の意味を取得する API が必要ですか? Free Dictionary API は、言語データを作品に組み込むための無料でアクセス可能な方法を提供します。このドキュメントでは、開始方法を説明します。

この API ドキュメントでは次のようになります。

• 無料辞書APIについて
• 終点
• 例
• 追加リソース

無料辞書APIについて：

meetDeveloper によって開発された無料の辞書 API で、GitHub に 2.6k のスターが付いています。 API は GET リクエストのみをサポートし、発音表記とともに単語の定義を提供します。

主な特徴:

• 無料で使用できます
• 使用制限なし
• 認証や API キーは必要ありません

終点

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

• このエンドポイントは、指定された英単語の辞書情報を取得します。

• API には v1 と v2 の 2 つのバージョンがあります。主な違いは応答構造にあります。現在のバージョンは v2.

クエリパラメータ

• word (文字列、必須): 調べたい単語。

応答フォーマット

API は、次のような単語に関する詳細情報を含む単一のオブジェクトを含む JSON 配列を返します。

リクエストが成功した場合:

• word(string): クエリされた単語
• phonetic(string): 単語の発音表記
• Phonetics(array): それぞれが次の要素を持つ音声オブジェクトの配列:
• text(string): 発音表記
• audio(string): 音声発音への URL (空の場合もあります)
• Meaning(array): 意味を表すオブジェクトの配列
• partOfSpeech (文字列): 品詞 (名詞、動詞など)
• 定義 (配列): 定義オブジェクトの配列。それぞれ:
を含みます。
• 定義 (文字列): 単語の定義
• 同義語(配列): 同義語の配列
• antononym (array): 反意語の配列
• License(object): データが提供されるライセンスに関する情報
• sourceUrls (配列): データのソースへの URL の配列

リクエストが成功しなかった場合:

• title (文字列): 単語
の定義が見つからなかったことを示すメッセージ
• メッセージ (文字列): 単語の定義が見つからないというメッセージ
• 解決策(文字列): 再度検索またはウェブを使用するための提案。

例:

リクエストの例 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 を試すか、無料辞書 API をサポートするには、無料辞書 API ウェブサイトにアクセスしてください。

Github の無料辞書 API プロジェクトも参照してください。