如何使用免费词典API

知识点掌握了，还需要不断练习才能熟练运用。下面golang学习网给大家带来一个文章开发实战，手把手教大家学习《如何使用免费词典API》，在实现功能的过程中也带大家重新温习相关知识点，温故而知新，回头看看说不定又有不一样的感悟！

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/

• 此端点检索指定英文单词的字典信息。

• 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 => 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 项目。

本篇关于《如何使用免费词典API》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！