API Rest

Gere tokens para que outras aplicações consigam utilizar as funcionalidades do tolvdesk. 

As APIs permitem uma integração entre aplicações. Em outras palavras, a comunicação entre essas aplicações. A API do tolvdesk permite que sejam consultadas informações sobre sua conta tolvdesk levando essas informações para o serviço ou aplicação programados. 

O token gerado nunca deve ser exposto ao usuário final. 

Importante: 

• É necessário conhecimento de programação para o uso deste recurso. 

• Lembramos que a responsabilidade sobre o correto uso desta API e a implicação da divulgação dos dados por ela expostos é sua, no momento que os procedimentos aqui detalhados não sejam cumpridos. 

• Em caso de perda ou roubo deste token, inative e gere um novo token dentro da listagem da API no administrador. 

• Caso você necessite fazer muitas consultas concorrentes, utilize um armazenamento local da informação, que seja atualizado a cada intervalo de tempo coerente para sua aplicação.

Cadastrando um token de acesso a API

Para cadastrar, inicie a sessão com seu login e senha de administrador e acesse o item "Administrador" no menu lateral para então, entrar em "Api Rest". Você encontra a listagem de tokens já gerados. Conheça os detalhes:

​

• Nome: Nome informado para fácil para identificação com a aplicação integrada. 

• Inativo/Ativo: Habilite para torná-lo ativo no sistema ou desabilite para que não seja utilizado. 

• Copiar token: Clique para copiar o token gerado. 

• Editar: Edite o conteúdo deste token. 

• Excluir: Clique para deletar este token. 

Novo token

Ao clicar em "Novo", preencha os campos solicitados para gerar um novo token:

​

• Nome do aplicativo: Use para identificação interna, não impacta em nada na utilização da API Rest.

• Permitir requisições apenas deste IP:  Valida o endereço da requisição e recusa caso a requisição venha de um endereço diferente. Deixe em branco para permitir o acesso de qualquer endereço.

Todos os campos com asterisco em vermelho são obrigatórios. 

Clique em "Continuar" e insira a sua senha do tolvdesk para concluir. 

Copiando o token

O token gerado entra automaticamente na listagem e você precisará clicar em "Copiar token" para deixá-lo na área de transferência. Copie o token privado gerado no sistema e utilize-o nas suas requisições.

Para aplicações personalizadas, consulte as documentações avançadas da API Rest: 

https://api.tolvdesk.com/