thiagonelsi / dicio-api

REST API de dicionário em português do Brasil / REST API to search for portuguese (Brazil) word meanings

API DOCS 📚🔎

O Dicio API permite buscas por diversas informações a respeito de milhares de palavras da língua portuguesa, todos os dados são extraídos do Dicio.

A API está atualmente na versão 2, em que é possível acessar os seguintes recursos:

• SIGNIFICADOS
• SINÔNIMOS
• SEPARAÇÃO SILÁBICA
• EXEMPLOS DE FRASES

Endpoints e Responses

Alerta: Rotas em português estão apenas disponíveis na versão 2.

Para utilizar a versão 2, lembre-se de adicionar o prefixo /v2/ para todos os endpoints.

Ex.:

• /v2/[palavra]
• /v2/sinonimos/[palavra]

Significados

Significados podem ser acessados através do método GET em qualquer uma das seguintes rotas:

• /[palavra]
• /significados/[palavra]
• /meanings/[palavra]

Response:

[
  {
    partOfSpeech: string,
    meanings: string[],
    etymology: string,
  }
]

Sinônimos:

Sinônimos podem ser acessados através do método GET em qualquer uma das seguintes rotas:

• /sinonimos/[palavra]
• /synonyms/[palavra]

Response:

string[]

Separação silábica

A separação silábica pode ser acessada através do método GET em qualquer uma das seguintes rotas:

• /silabas/[palavra]
• /syllables/[palavra]

Response:

string[]

Frases

Frases com a palavra podem ser acessada através do método GET em qualquer uma das seguintes rotas:

• /frases/[palavra]
• /sentences/[palavra]

Response:

[
  {
    sentence: string,
    author: string
  },
  {
    sentence: string,
    author: string
  }
]

---

Exemplos de uso:

Usando a palavra livro 📗 como exemplo, vamos começar buscando seu significado:

Significados

https://dicio-api-ten.vercel.app/v2/livro

A resposta é um array de objetos. Cada objeto possui partOfSpeech (classe gramatical da palavra), meanings (array de strings com os diversos sentidos que a palavra pode assumir) e etymology (etimologia da palavra).

[
  {
    "partOfSpeech": "substantivo masculino",
    "meanings": [
      "Conjunto de folhas impressas e reunidas em volume encadernado ou brochado.",
      "Obra em prosa ou verso, de qualquer extensão, disponibilizada em qualquer meio ou suporte: livro bem escrito; livro eletrônico.",
      "Divisão menor contida numa obra maior: livro dos salmos.",
      "[Literatura] Divisão de uma obra, especialmente de uma epopeia.",
      "Caderno de registro das operações comerciais de; livro-caixa.",
      "[Figurado] Conjunto de saberes, usado como instrução, ou como fonte de ensino: livro de sabedoria."
    ],
    "etymology": "Etimologia (origem da palavra livro). Do latim liber.bri."
  }
]

Palavras com múltiplas classes gramaticais

Quando uma palavra possui mais de uma classe gramatical e significados diferentes, as classes gramaticais e seus respectivos significados são divididos em outro objeto

Exemplo com a palavra a

[
  {
    "partOfSpeech": "artigo definido",
    "meanings": [
      "Artigo definido feminino de o: a bola, a casa."
    ],
    "etymology": ""
  },
  {
    "partOfSpeech": "preposição",
    "meanings": [
      "Exprime relação de movimento: ir a São Paulo.",
      "Indica tempo: partir a 20 de janeiro.",
      "Expressa um fim, objetivo, propósito: viajar a negócios.",
      "Demonstra um meio: atravessar a ponte a pé.",
      "Indica um instrumento: quebrar pedras a picareta.",
      "Estabelece uma relação de modo: andar a galope.",
      "Introduz um preço, valor: vender livros a quinze reais.",
      "[Gramática] Introduz o objeto indireto: beijar a mão a uma dama."
    ],
    "etymology": ""
  },
  {
    "partOfSpeech": "substantivo masculino",
    "meanings": [
      "Primeira letra do alfabeto e primeira das vogais.",
      "Toda representação da forma, do som ou do tipo impresso dessa letra: palavra escrita com o a aberto.",
      "[Música] Forma de representação do lá."
    ],
    "etymology": ""
  },
  ...
]

Sinônimos:

https://dicio-api-ten.vercel.app/v2/sinonimos/livro

[
  "alfarrábio",
  "calhamaço",
  "cartapácio"
]

Separação silábica:

https://dicio-api-ten.vercel.app/v2/silabas/livro

[
  "li",
  "vro"
]

Exemplos de frases:

https://dicio-api-ten.vercel.app/v2/frases/livro

[
  {
    "sentence": "No fim tu hás de ver que as coisas mais leves são as únicas que o vento não conseguiu levar: um estribilho antigo um carinho no momento preciso o folhear de um livro de poemas o cheiro que tinha um dia o próprio vento...",
    "author": "- Mário Quintana"
  },
  {
    "sentence": "O livro é um mestre que fala mas que não responde.",
    "author": "- Platão"
  },
  {
    "sentence": "Em 9 de setembro passado, o Tribunal Civil de Lisboa proibiu, em caráter cautelar, a venda do livro.",
    "author": "Folha de S.Paulo, 11/01/2010"
  },
  {
    "sentence": "O sucesso on-line transformou os posts em livro.",
    "author": "Folha de S.Paulo, 27/06/2009"
  },
  {
    "sentence": "Veja abaixo trecho do livro com descrição dos melhores locais para visitar na \"cidade maravilhosa\".",
    "author": "Folha de S.Paulo, 02/10/2009"
  }
]

dicio-api's Issues

Recuperar múltiplos sentidos de sinônimos

É possível recuperar todas as listas de sinônimos ao invés de só uma (imagino que seja a primeira)?
Além disso, eu gostaria de saber qual é a fonte dos dados, pois comparando com o site https://www.sinonimos.com.br/, os resultados são diferentes. A API utiliza dados crawleados antigos?

Exemplo:

No site, a palavra cidade apresenta 2 sentidos, que são os seguintes:

1. Povoação urbana: [urbe, urbanização, município, burgo, povoação, povoamento, localidade]
2. Centro comercial, financeiro, administrativo,...: [centro, sede, metrópole, capital, cidade-estado, pólis]

Enquanto o resultado da API é o seguinte:

["capital","município","povoação","centro","urbe"]

Gostaria de saber se é possível obter uma saída como a seguinte:

[
    [urbe, urbanização, município, burgo, povoação, povoamento, localidade],
    [centro, sede, metrópole, capital, cidade-estado, pólis]
]

Multiplas palavras

Eh possivel enviar para sinonimos uma lista de palavras e pegar os sinonimos da mesma? Ou so uma palavra por vez?

Se eh possivel, como eh feito?

Exemplo, buscar sinomimos de Amor+Odio+Amigos

E retornar algo como, [casal, inimigos, sentimentos]

Rota /sentences está retornando caracteres `\n` no meio da string.

Exemplo com a palavra livro (/sentences/livro):

[
  {
    "sentence": "No fim tu hás de ver que as coisas mais leves são as únicas\nque o vento não conseguiu levar:\num estribilho antigo\num carinho no momento preciso\no folhear de um livro de poemas\no cheiro que tinha um dia o próprio vento...",
    "author": "- Mário Quintana"
  }
]

Impossibilidade de retorno de significados de palavras com grafia igual mas acentuação diferente.

Olá Thiago! Interessante a ideia da API.

Percebi que não tem como retornar o significado de algumas palavras, de acordo com a acentuação.
Palavras como: 'coco, cocó, cocô e coço', 'metro e metrô'.

Algumas palavras estão retornando undefined

As palavras situada e classes, por exemplo, está retornando esse erro:

{
  "error": "Cannot read property 'meanings' of undefined"
}

Criar testes

Criar testes para a rota principal, utilizando várias palavras diferentes para os testes.

Palavras com diferentes acentuações não podem ser retornadas ao usar allMeanings

Palavras, como vovô, que possuem duas ou mais opções de acentuações não podem ser achadas. No caso de vovô, ao usar allMeanings/vovo, apenas vovó é retornado. Não sei se é culpa do próprio sistema do Dicio ou se é um problema especificamente desta palavra já que o mesmo problema não acontece com avô, avó e avo.

Palavras que são apenas acentuadas não podem ser encontradas ao usar versão acentuada para obter dados

Na v1, ao usar o allMeanings, resolvia um problema das palavras apenas acentuadas, como feijão. O Dicio não disponibiliza a versão feijão, apenas feijao, veja:

• v2/feij%C3%A3o — retorna um erro
• v2/feijao — retorna feijão
• allMeanings/feij%C3%A3o — retorna feijão
• dicio.com.br/feijao — retorna feijão
• dicio.com.br/feij%C3%A3o — não encontra

Não sei se será possível corrigir isto, já que a culpa é do Dicio, mas como eu disse, com o allMeanings era corrigido

Rota de sinônimos retorna também os antônimos da palavra.

Ao acessa a rota /synonyms/[palavra] a API retorna tanto os sinônimos quanto os antônimos da palavra requisitada.

Pode-se reproduzir o bug procurando, por exemplo, pela palavra afeto

Retorno da API

Retorno esperado

API fora do ar

Fala pessoal! Como vcs estão?

Vinha utilizando a API aqui, e de repente parece que ela está fora do ar, no link: https://significado.herokuapp.com/

Alguém sabe me dizer se ela está online em algum outro link?

Abraços!

API não funciona (heroku error)

A página simplesmente devolve um 503 com a página de erro do Heroku

No 'Access-Control-Allow-Origin' header is present on the requested resource.

Olá Thiago, quando faço uma requisição estou tendo esse problema de CORS. Teria alguma solução para resolver este problema?

Ideia de dados na API

Acredito que faltou expor o plural da palavra e o gênero oposto, e isso ia ser muito importante para muitas aplicações.

Consulta de api

Bom dia sou desenvolvedor do projeto http://pat.educacao.ba.gov.br, e estou querendo implementar uma sugestão de palavra quando não existir tags cadastrados em nosso banco, seu projeto que esta no heroku é permanente??

API Off

Consumo de API

Chamadas sem partOfSpeech

Primeiramente, parabéns na API cara!

Eu encontrei algumas palavras que não estão trazendo nenhum resultado para [partOfSpeech] quando invocadas, sabes dizer se isso é esperado em tempos verbais?

Segue as chamadas abaixo:

https://significado.herokuapp.com/v2/viu
https://significado.herokuapp.com/v2/vou

Na documentação eu não encontrei uma forma de conseguir identificar os tempos verbais deles, existe alguma forma hoje de se realizar isso?

Obrigado e continue o bom trabalho!

Erro de CORS

Estou usando essa API em um projeto disciplinar, mas recentemente tenho recebido um erro de CORS ao fazer uma requisição.
Tenho a aplicação local, e no ar atrave´s do Github Pages e recebo o erro em ambas. Não fiz nenhuma alteração no código, simplesmente comecei a receber esse no console:
<Access to fetch at 'https://dicio-api-ten.vercel.app/v2/livro' from origin 'http://127.0.0.1:5500' has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource. If an opaque response serves your needs, set the request's mode to 'no-cors' to fetch the resource with CORS disabled.>

Erro 503

Todos os requests retornam um erro 503, tanto no dicio quanto na api. De acordo com alguns testes que fiz, é por conta de algum tipo de atualização no dicio.

Agora todos os endereços de pesquisa precisam de uma / ao final, caso contrário, o site retorna um erro 503

Sem a barra:

Com a barra:

Adicionar uma / ao final da url deve funcionar :)

API fora do ar

A api tá fora do ar, fica dando status 404:

https://dicio-api-ten.vercel.app/v2/livro

Res:

The deployment could not be found on Vercel.

DEPLOYMENT_NOT_FOUND