如何使用免费词典API

php中文网 2024-10-15 11:55:47

unsplash 上的封面照片由 christopher gower

您是否正在开发语言学习应用程序、写作助手或任何涉及单词并需要 api 来检索单词含义的项目？免费词典 api 提供了一种免费且易于访问的方式，将语言数据合并到您的作品中。本文档将向您展示如何开始。

在此 api 文档中：

关于免费词典 api
端点
示例
其他资源

关于免费词典 api：

由 meetdeveloper 开发的免费词典 api，在 github 上拥有 2.6k star。 api 仅支持 get 请求，并提供单词定义和音标。

主要特点：

免费使用
无使用限制
无需授权或 api 密钥

端点

https://api.dictionaryapi.dev/api/v2/entries/en/<word></word>

此端点检索指定英文单词的字典信息。
api 有两个版本：v1 和 v2。主要区别在于响应结构。当前版本是 v2。

查询参数

单词（字符串，必需）：您要查找的单词。

响应格式

api 返回一个 json 数组，其中包含单个对象，其中包含有关单词的详细信息，包括：

如果请求成功：

word(string): 查询的单词
voicetic(string): 单词的音标
voicetics(array): 语音对象数组，每个对象包含：
text(string): 音标
audio(string): 音频发音的 url（可能为空）
含义（数组）：表示含义的对象数组
partofspeech（字符串）：词性（例如名词、动词）
定义（数组）：定义对象的数组，每个对象包含：
定义（字符串）：单词
synonyms(array): 同义词数组
antonyms (array): 反义词数组
许可证（对象）：有关提供数据的许可证的信息
sourceurls (array): 数据源的 url 数组

如果请求不成功：

title (string): 一条消息，表明没有找到单词
message（字符串）：未找到该单词的定义的消息
解决方案（字符串）：建议再次使用搜索或网络。

示例：

请求示例 1（成功）：

const word = "documentation";
fetch(`https://api.dictionaryapi.dev/api/v2/entries/en/${word}`)
  .then(response =&gt; response.json())
  .then(data =&gt; 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 =&gt; response.json())
  .then(data =&gt; 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."
}