표지 사진: Christopher Gower, Unsplash

언어 학습 앱, 글쓰기 도우미 또는 단어와 관련된 프로젝트를 개발 중이고 단어 의미를 검색하기 위한 API가 필요합니까? 무료 사전 API는 언어 데이터를 작업에 통합할 수 있는 무료이며 접근 가능한 방법을 제공합니다. 이 문서에서는 시작하는 방법을 보여줍니다.

이 API 문서에서:

• 무료 사전 API 정보
• 엔드포인트
• 예
• 추가 리소스

무료 사전 API 정보:

metDeveloper가 개발한 무료 Dictionary API이며 GitHub에 2600개의 별이 있습니다. API는 GET 요청만 지원하며 음성 표기와 함께 단어 정의를 제공합니다.

주요 특징:

• 무료로 사용
• 사용 제한 없음
• 인증 또는 API 키가 필요하지 않습니다.

엔드포인트

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

• 이 엔드포인트는 지정된 영어 단어에 대한 사전 정보를 검색합니다.

• API에는 v1과 v2의 두 가지 버전이 있습니다. 주요 차이점은 응답 구조에 있습니다. 현재 버전은 v2입니다.

쿼리 매개변수

• 단어 (문자열, 필수): 조회하려는 단어입니다.

응답 형식

API는 다음을 포함하여 단어에 대한 자세한 정보가 포함된 단일 개체가 포함된 JSON 배열을 반환합니다.

요청이 성공한 경우:

• word(string): 쿼리된 단어
• phonetic(string): 단어
의 음성 표기
• Phonetics(array): 각각 다음을 포함하는 음성 객체의 배열:
• text(string): 음성 표기
• audio(string): 오디오 발음에 대한 URL(비어 있을 수 있음)
• meanings(array): 의미를 나타내는 객체의 배열
• partOfSpeech (string): 품사(예: 명사, 동사)
• 정의(배열): 각각 다음을 포함하는 정의 개체의 배열:
• 정의(문자열): 단어
의 정의
• 동의어(array): 동의어 배열
• antonyms (array): 반의어 배열
• 라이센스(객체): 데이터가 제공되는 라이센스에 대한 정보
• sourceUrls(배열): 데이터 소스에 대한 URL 배열

요청이 성공하지 못한 경우:

• title (string): 단어
에 대한 정의를 찾을 수 없음을 나타내는 메시지
• message (string) : 해당 단어에 대한 정의를 찾을 수 없다는 메시지
• 해상도(문자열): 검색을 다시 사용하거나 웹을 사용하도록 제안합니다.

예:

예시 요청 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의 Free Dictionary API 프로젝트도 참조하세요.