Autenticação (API Iara)

Todas as funcionalidades do SDK dependem de uma autenticação com a API Iara. Para realizar a autenticação, você precisa do seguinte:

• Um apiToken para sua aplicação;
• Um ou mais userId (um para cada usuário da sua aplicação).

Dica: ainda não possui um userId e apiToken? Escreva para contato@iarahealth.com para conseguir suas credenciais da API Iara.

O valor de apiToken é o código de acesso que sua aplicação ganha para utilizar os serviços da Iara Health. Geralmente esse valor é um hash de 32 caracteres. Você precisa de um único apiToken por aplicação.

O valor de userId, porém, é usado para identificar cada usuário da sua aplicação. Como o reconhecimento de voz da Iara é personalizado por usuário, cada usuário deve possuir um userId próprio. O valor do userId identifica unicamente uma pessoa e é usado para download e ajuste de um modelo de voz próprio para o usuário em questão.

IMPORTANTE: usuários diferentes não devem utilizar um mesmo userId. Se isso acontecer, a acurácia do reconhecimento de voz será degradada.

Autenticação durante a inicialização

A inicialização do reconhecedor da Iara Health requer uma autenticação. A autenticação é feita através das propriedades obrigatórias userId e apiToken passadas ao método init():

var recognition = new IaraSpeechRecognition();

recognition.init({
    userId: 'meu@email.com',
    apiToken: '197765800edb8affcb44a7ae7b4ff0a3'

}).done(function(e) {
    // Tudo certo, o reconhecimento pode começar.
}).fail(function(e) {
    // Algum problema aconteceu.
});

O exemplo userId-apiToken-test contém códigos prontos referentes à autenticação. Além disso, veja a seção Inicialização saber mais sobre sobre a inicialização do reconhecedor.