Introdução

Esta página demonstra como integrar o Houaiss.on ao seu site. Seus usuários poderão digitar ou clicar nas palavras para acessar o Houaiss, sem necessitar de login ou senha.

É muito simples de usar. Os passos são:

1. criar um login específico para o serviço. Entre em contato conosco para o criarmos para você
2. fazer chamadas de seu back-end para nosso servidor REST, que entrega os verbetes desejados
3. mostrar os verbetes aos seus usuários da forma como preferir. Nossas bibliotecas javascript podem ajudá-lo a fazer isso

Exemplo de uso

Para ver um exemplo de funcionamento usando o botão abaixo. Se tiver dúvidas entre em contato conosco (email contato@iah.com.br)

A biblioteca pode ser carregada automaticamente junto com a página, ou por solicitação do usuário, como fez aqui. Uma vez carregada o usuário poderá usá-la para:

1 - digitar palavras e fazer consultas (usando a janela que apareceu em um canto de sua tela)
2 - clicar nas palavras da página para fazer consultas. Em sua configuração inicial, a tecla alt deverá ser pressionada

Experimente ambas as funções. A biblioteca foi carregada aqui para executar ambas as funções, mas a configuração inicial pode ser ao seu gosto. Além disso, o usuário pode configurá-la manualmente, clicando no botão de configuração. Ou podem ser utilizados comandos externos. Veja exemplos usando os botões abaixo:

seleção ligada  seleção desligada  seleção + alt ligada  seleção + ctrl ligada

Basta fazer o download da biblioteca e utilizá-la em seu site. Se desejar usar o serviço dedicado de outra forma, você pode criar a sua própria. O servidor pode enviar informações no formato HTML, JSON ou XML. Mais abaixo há instruções de como ele funciona

Download e configuração da biblioteca

Para fazer o download dos arquivos que compõem a biblioteca, clique aqui

O arquivo leiame.txt contém as instruções de instalação e configuração

Desenvolvendo sua própria biblioteca

Caso nossa biblioteca não o atenda, você poderá desenvolver a sua própria. Abaixo há um detalhado tutorial de como fazê-lo. Entre em contato conosco. Poderemos ajudá-lo

Logos e imagens

este link permite baixar alguns de nossos logos caso queira utilizar:
download aqui

Enviando uma solicitação

O serviço dedicado escuta no endereço de internet https://houaiss.online/houaisson/apps/webserver/vopen/conexao.php, e para usá-lo basta fazer uma chamada através de GET ou POST a este endereço. Abaixo segue descrição dos dados a serem enviados ao fazer a conexão:

Dados obrigatórios

"login" : login do cliente
"senha" : senha do cliente
"palavra" : palavra a ser pesquisada

Dados opcionais

"dic" : o dicionário a ser consultado. Este atributo pode assumir os seguintes valores:
   "grande" para consultar o dicionário de língua portuguesa. Valor padrão
   "sinant" para consultar o dicionário de sinônimos e antônimos

"formato" : forma de retorno das informações. Este atributo pode assumir os seguintes valores:
   "html" para retorno através de HTML. Valor padrão (recomendado para fácil visualização)
   "json" para retorno através de JSON (recomendado para fazer um parser das diversas informações)
   "array" para retorno através de XML (recomendado para visualizar a estrutura do JSON)

"fonte" : tamanho da fonte usada no retorno através de HTML
   "1" para fonte pequena
   "2" para fonte média
   "3" para fonte grande

Recebendo a resposta

O serviço dedicado fica no ar 24h por dia, e a resposta à consulta realizada é dada imediatamente em resposta à solicitação do cliente. O servidor analisa a palavra solicitada e considera em sua resposta possíveis variações (como de gênero, número e grau). São consideradas também variações as conjugações verbais. Caso nenhuma palavra seja encontrada após esta análise, o servidor assume um possível erro ortográfico e sugere alternativas. As melhores respostas consideradas pelo servidor são enviadas como resposta da solicitação, conforme o tipo de retorno solicitado no atributo "ret".

Tipos de respostas

"formato" = "html" : a resposta será enviada através de html. Neste caso, geralmente nenhum tratamento gráfico é necessário.

"formato" = "json" : a resposta será enviada através de um documento JSON padrão. Este tipo de resposta é desejável, se o cliente quiser trabalhar os dados recebidos individualmente, ou se desejar dar um tratamente gráfico particular. O conteúdo dos verbetes é enviado dentro de uma estrutura em vários níveis, que incluem, por exemplo, "entrada", "datacao", "classe", "definicao", conjugacao" etc. São dezenas de tipos de informações diferentes, de forma que o cliente pode usar apenas aquela em que está realmente interessado.

"formato" = "array" : a resposta será enviada através de uma estrutura esquemática de fácil visualização. Esta resposta é recomendada para a correta interpretação dos dados equivalentes em json.

Verbetes especiais

Há dois tipos de verbetes especiais. Eles são:
"(bibliografia)" : retorna uma tabela com todas as informações bibliográficas do Grande Dicionário Houaiss.
"(reducoes)" : retorna uma tabela com todas as reduções usadas no Grande Dicionário Houaiss.

Interpretando o JSON

Se optar por utilizar as respostas JSON ou XML para obter um resultado mais personalizado às suas necessidades, alguns procedimentos serão necessários. É importante entender os vários tipos de informação enviados, e também as tags de formatação de texto

Tags de formatação usadas

Dentro dos diversos campos do JSON, são utilizadas tags para a correta formatação dos dados. As tags que podem ser usadas dentro dos textos são estas:

<res>...</res> : o conteúdo dentro das tags é uma abreviação
<rem>...</rem> : o conteúdo dentro das tags é um verbete sugerido para consulta
<b>...</b> : o conteúdo dentro das tags deve estar em negrito
<i>...</i> : o conteúdo dentro das tags deve estar em itálico
<u>...</u> : o conteúdo dentro das tags deve estar sublinhado
^... : o conteúdo dentro das tags deve estar ^sobrescrito
_... : o conteúdo dentro das tags deve estar _subscrito
<cor1>...</cor1> : o conteúdo dentro das tags deve estar com uma cor distinta
<ve>...</ve> : o conteúdo dentro das tags deve estar em versalete

Campos do JSON - dicionário de língua portuguesa

Os exemplos abaixo permitem ver os resultados e entender os campos retornados. Para fazer a implantação local, basta trocar os textos "seulogin" e "suasenha" pelos dados corretos. As credenciais "seulogin" e "suasenha" permitem acesso apenas aos exemplos abaixo

"foi" : exemplo de retornos múltiplos

"privada" : exemplo de retornos múltiplos

"venezuela" : exemplo de verbete externo

"bordo" : exemplo de retornos múltiplos

"adevogado" : exemplo de verbete com erro ortográfico

"amazonas" : exemplo de retornos múltiplos

"brennschluss" : exemplo de palavra estrangeira

"lycra" : exemplo de palavra estrangeira

"aurora" : exemplo de retornos múltiplos

"senhor" : exemplo de verbete com muitos elementos

"abinhadeira" : exemplo de verbete inexistente

"cacoula" : exemplo de verbete que ignora acento ou ç

"meteorito" : exemplo de verbete com elementos raros

"aboar" : exemplo de verbete com elementos raros

"casar" : exemplo de retorno múltiplo

"oxigenio" : exemplo de verbete com elementos raros

"papel" : exemplo de retorno múltiplo

"bobo" : exemplo de retorno múltiplo

"email" : exemplo de entrada múltipla

Campos do JSON - dicionário de sinônimos e antônimos

Os exemplos abaixo permitem ver os resultados e entender os campos retornados. Para fazer a implantação local, basta trocar os textos "seulogin" e "suasenha" pelos dados corretos. As credenciais "seulogin" e "suasenha" permitem acesso apenas aos exemplos abaixo

ex: "foi" : exemplo de retornos múltiplos

ex: "disciplina" : exemplo de retornos múltiplos

ex: "abdome" : exemplo de entrada múltipla

ex: "gordo" : exemplo de verbete com elementos raros

ex: "conta" : exemplo de verbete com elementos raros

ex: "geral" : exemplo de verbete com elementos raros

ex: "acasalar" : exemplo de verbete com elementos raros

ex: "acochar" : exemplo de verbete com elementos raros

ex: "foi" : exemplo de entrada múltipla