Titelbild von Christopher Gower auf Unsplash

Entwickeln Sie eine Sprachlern-App, einen Schreibassistenten oder ein anderes Projekt mit Wörtern und benötigen eine API, um Wortbedeutungen abzurufen? Die Free Dictionary API bietet eine kostenlose und zugängliche Möglichkeit, Sprachdaten in Ihre Arbeit zu integrieren. Diese Dokumentation zeigt Ihnen, wie Sie beginnen.

In dieser API-Dokumentation:

• Über die kostenlose Wörterbuch-API
• Endpunkt
• Beispiele
• Zusätzliche Ressourcen

Über die kostenlose Wörterbuch-API:

Kostenlose Wörterbuch-API, entwickelt von meetDeveloper und hat 2,6.000 Sterne auf GitHub. Die API unterstützt nur GET-Anfragen und stellt Wortdefinitionen zusammen mit phonetischen Transkriptionen bereit.

Hauptmerkmale:

• Kostenlose Nutzung
• Keine Nutzungsbeschränkungen
• Keine Autorisierung oder API-Schlüssel erforderlich

Endpunkt

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

• Dieser Endpunkt ruft Wörterbuchinformationen für das angegebene englische Wort ab.

• Die API hat zwei Versionen: v1 und v2. Der Hauptunterschied liegt in der Antwortstruktur. Aktuelle Version ist v2.

Abfrageparameter

• Wort (Zeichenfolge, erforderlich): Das Wort, nach dem Sie suchen möchten.

Antwortformat

Die API gibt ein JSON-Array zurück, das ein einzelnes Objekt mit detaillierten Informationen zum Wort enthält, einschließlich:

Wenn die Anfrage erfolgreich ist:

• Wort(Zeichenfolge): Das abgefragte Wort
• phonetic(string): Die phonetische Transkription des Wortes
• phonetics(array): Ein Array phonetischer Objekte mit jeweils:
• text(string): Die phonetische Transkription
• audio(string): Eine URL zu einer Audioaussprache (kann leer sein)
• meaning(array): Ein Array von Objekten, die Bedeutungen darstellen
• partOfSpeech (Zeichenfolge): Die Wortart (z. B. Substantiv, Verb)
• Definitionen (Array): Ein Array von Definitionsobjekten mit jeweils:
• definition (string): Die Definition des Wortes
• synonyme(array): Ein Array von Synonymen
• Antonyme (Array): Ein Array von Antonymen
• Lizenz(Objekt): Informationen über die Lizenz, unter der die Daten bereitgestellt werden
• sourceUrls (array): Ein Array von URLs zu den Quellen der Daten

Wenn die Anfrage nicht erfolgreich ist:

• Titel (Zeichenfolge): Eine Meldung, die angibt, dass für das Wort
keine Definitionen gefunden wurden.
• Nachricht (Zeichenfolge): Nachricht, dass die Definitionen für das Wort nicht gefunden wurden
• Auflösung(Zeichenfolge): Vorschlag, die Suche erneut oder das Web zu verwenden.

Beispiele:

Beispielanfrage 1 (erfolgreich):

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

Beispielantwort 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"
    ]
  }
]

Beispielanfrage 2:

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

Beispielantwort 2 (nicht erfolgreich):

{
  "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."
}

Erfolgs- und Fehlercodes

Diese API gibt derzeit keine spezifischen Erfolgs- oder Fehlercodes zurück.

Zusätzliche Ressourcen

Um die API auszuprobieren oder die Free Dictionary API zu unterstützen, besuchen Sie die Website der Free Dictionary API.

Siehe auch Free Dictionary API-Projekt auf Github.