Foto da capa de Christopher Gower no Unsplash

Você está desenvolvendo um aplicativo de aprendizagem de idiomas, um assistente de redação ou algum projeto que envolva palavras e precisa de uma API para recuperar o significado das palavras? A API de dicionário gratuita oferece uma maneira gratuita e acessível de incorporar dados de idioma em seu trabalho. Esta documentação mostrará como começar.

Nesta documentação da API:

• Sobre a API de dicionário gratuita
• Ponto final
• Exemplos
• Recursos Adicionais

Sobre a API de dicionário gratuita:

API de dicionário gratuita desenvolvida por meetDeveloper e tem 2,6 mil estrelas no GitHub. A API oferece suporte apenas a solicitações GET e fornece definições de palavras junto com transcrições fonéticas.

Principais recursos:

• Grátis para usar
• Sem limites de uso
• Não é necessária autorização ou chaves de API

Ponto final

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

• Este endpoint recupera informações do dicionário para a palavra em inglês especificada.

• A API tem duas versões: v1 e v2. A principal diferença está na estrutura da resposta. A versão atual é v2.

Parâmetros de consulta

• palavra (string, obrigatório): a palavra que você deseja procurar.

Formato de resposta

A API retorna um array JSON contendo um único objeto com informações detalhadas sobre a palavra, incluindo:

Se a solicitação for bem-sucedida:

• palavra(string): A palavra consultada
• fonético(string): A transcrição fonética da palavra
• fonética(matriz): Uma matriz de objetos fonéticos, cada um com:
• text(string): A transcrição fonética
• audio(string): Um URL para uma pronúncia de áudio (pode estar vazio)
• significados (matriz): uma matriz de objetos que representam significados
• partOfSpeech (string): A classe gramatical (por exemplo, substantivo, verbo)
• definições (matriz): uma matriz de objetos de definição, cada um com:
• definição (string): A definição da palavra
• sinônimos (matriz): uma matriz de sinônimos
• antônimos (matriz): uma matriz de antônimos
• licença(objeto): Informações sobre a licença sob a qual os dados são fornecidos
• sourceUrls (array): uma matriz de URLs para as fontes dos dados

Se a solicitação não for bem-sucedida:

• título (string): Uma mensagem indicando que nenhuma definição foi encontrada para a palavra
• mensagem (string): Mensagem de que as definições da palavra não foram encontradas
• resolução(string): Sugestão para usar a pesquisa novamente ou web.

Exemplos:

Exemplo de solicitação 1 (bem-sucedida):

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

Exemplo de resposta 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"
    ]
  }
]

Exemplo de solicitação 2:

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

Exemplo de resposta 2 (sem ê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 sucesso e erro

No momento, esta API não retorna códigos de erro ou sucesso específicos.

Recursos Adicionais

Para experimentar a API ou oferecer suporte à API do Dicionário Gratuito, acesse o site da API do Dicionário Gratuito.

Veja também o projeto Free Dictionary API no Github.