Photo de couverture par Christopher Gower sur Unsplash

Développez-vous une application d'apprentissage des langues, un assistant d'écriture ou tout autre projet impliquant des mots et avez-vous besoin d'une API pour récupérer la signification des mots ? L'API Free Dictionary offre un moyen gratuit et accessible d'incorporer des données linguistiques dans votre travail. Cette documentation vous montrera comment démarrer.

Dans cette documentation API :

• À propos de l'API de dictionnaire gratuit
• Point de terminaison
• Exemples
• Ressources supplémentaires

À propos de l'API de dictionnaire gratuit :

API de dictionnaire gratuite développée par meetDeveloper et compte 2,6 000 étoiles sur GitHub. L'API prend uniquement en charge les requêtes GET et fournit des définitions de mots ainsi que des transcriptions phonétiques.

Principales caractéristiques :

• Utilisation gratuite
• Aucune limite d'utilisation
• Aucune autorisation ou clé API requise

Point de terminaison

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

• Ce point de terminaison récupère les informations du dictionnaire pour le mot anglais spécifié.

• L'API existe en deux versions : v1 et v2. La principale différence réside dans la structure de la réponse. La version actuelle est la v2.

Paramètres de requête

• mot (chaîne, obligatoire) : le mot que vous souhaitez rechercher.

Format de réponse

L'API renvoie un tableau JSON contenant un seul objet avec des informations détaillées sur le mot, notamment :

Si la demande aboutit :

• word(string) : Le mot interrogé
• phonetic(string) : La transcription phonétique du mot
• phonetics(array) : Un tableau d'objets phonétiques, chacun avec :
• text(string) : La transcription phonétique
• audio(string) : une URL vers une prononciation audio (peut être vide)
• significations (array) : un tableau d'objets représentant des significations
• partOfSpeech (string) : partie du discours (par exemple, nom, verbe)
• définitions (array) : un tableau d'objets de définition, chacun avec :
• définition (chaîne) : La définition du mot
• synonyms(array) : Un tableau de synonymes
• antonymes (tableau) : un tableau d'antonymes
• licence(objet) : informations sur la licence sous laquelle les données sont fournies
• sourceUrls (array) : un tableau d'URL vers les sources des données

Si la demande n'aboutit pas :

• title (string) : un message indiquant qu'aucune définition n'a été trouvée pour le mot
• message (chaîne) : message indiquant que les définitions du mot n'ont pas été trouvées
• résolution(string) : suggestion d'utiliser à nouveau la recherche ou le Web.

Exemples :

Exemple de demande 1 (réussie) :

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

Exemple de réponse 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"
    ]
  }
]

Exemple de demande 2 :

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

Exemple de réponse 2 (échec) :

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

Codes de réussite et d'erreur

Cette API ne renvoie actuellement aucun code de réussite ou d'erreur spécifique.

Ressources supplémentaires

Pour essayer l'API ou prendre en charge l'API Free Dictionary, accédez au site Web de l'API Free Dictionary.

Voir également le projet API de dictionnaire gratuit sur Github.