Foto de portada de Christopher Gower en Unsplash

¿Estás desarrollando una aplicación de aprendizaje de idiomas, un asistente de escritura o cualquier proyecto que involucre palabras y necesitas una API para recuperar el significado de las palabras? Free Dictionary API ofrece una forma gratuita y accesible de incorporar datos lingüísticos en su trabajo. Esta documentación le mostrará cómo empezar.

En esta documentación de API:

• Acerca de la API de diccionario gratuita
• Punto final
• Ejemplos
• Recursos adicionales

Acerca de la API de diccionario gratuita:

API de diccionario gratuita desarrollada por meetDeveloper y tiene 2,6k estrellas en GitHub. La API solo admite solicitudes GET y proporciona definiciones de palabras junto con transcripciones fonéticas.

Características clave:

• De uso gratuito
• Sin límites de uso
• No se requiere autorización ni claves API

Punto final

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

• Este punto final recupera información del diccionario para la palabra en inglés especificada.

• La API tiene dos versiones: v1 y v2. La principal diferencia radica en la estructura de respuesta. La versión actual es v2.

Parámetros de consulta

• palabra (cadena, obligatoria): La palabra que desea buscar.

Formato de respuesta

La API devuelve una matriz JSON que contiene un único objeto con información detallada sobre la palabra, que incluye:

Si la solicitud tiene éxito:

• palabra (cadena): la palabra consultada
• fonético (cadena): la transcripción fonética de la palabra
• fonética(matriz): una matriz de objetos fonéticos, cada uno con:
• texto(cadena): La transcripción fonética
• audio(cadena): una URL a una pronunciación de audio (puede estar vacía)
• significados (matriz): una matriz de objetos que representan significados
• partOfSpeech (cadena): la parte del discurso (p. ej., sustantivo, verbo)
• definiciones (matriz): una matriz de objetos de definición, cada uno con:
• definición (cadena): La definición de la palabra
• sinónimos (matriz): una matriz de sinónimos
• Antónimos (matriz): una variedad de antónimos
• licencia(objeto): Información sobre la licencia bajo la cual se proporcionan los datos
• sourceUrls (matriz): una matriz de URL a las fuentes de datos

Si la solicitud no tiene éxito:

• título (cadena): un mensaje que indica que no se encontraron definiciones para la palabra
• mensaje (cadena): Mensaje de que no se encontraron las definiciones de la palabra
• resolución(cadena): Sugerencia para usar la búsqueda nuevamente o la web.

Ejemplos:

Ejemplo de solicitud 1 (exitosa):

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

Ejemplo de respuesta 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"
    ]
  }
]

Ejemplo de solicitud 2:

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

Ejemplo de respuesta 2 (sin éxito):

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

Códigos de éxito y error

Esta API actualmente no devuelve códigos de éxito o de error específicos.

Recursos adicionales

Para probar la API o admitir la API del Diccionario gratuito, vaya al sitio web de la API del Diccionario gratuito.

Ver también el proyecto API de diccionario gratuito en Github.