O Token de Acesso é uma chave necessária para realizar a comunicação com a API.
Esse token não pode ser divulgado em hipótese alguma, pois ele permite o acesso completo a API.
A criação e edição do token requer que o usuário seja proprietário da conta ou possuir permissões de administrador.
Criação
Para criar um token siga as instruções abaixo:
- No Painel Administrativo acesse o menu Gestão › Configurações da Conta
- No menu "Configurações da conta", clique em API
- Clique no botão Novo Token;
- Preencha as informações requisitas;
- Clique em Salvar Token.
Ao realizar essa operação, será criado o token e a chave será exibida.
Edição
Um token pode ser editado. Essa operação permite alterar as configurações dele, mas não a chave.
Exclusão
Ao excluir um token, ele não pode ser mais recuperado, e qualquer chamada à API que utilize este token irá ser rejeitada.
Propriedades
O token ao ser criado e editado possui as seguintes propriedades:
- Descrição: Uma descrição para identificar o seu token, como por exemplo, a finalidade dele;
- IPs: Uma lista de IP ou faixa de IPs que são permitidos a utilizar o token, caso esteja vazio, qualquer IP poderá se conectar na API e usar seu token;
- Expiração: Um token pode ser utilizado sem tempo limite de uso, ou poderá ter um período pré-definido de validade. Caso seja escolhido um período, ele não será mais acessível após esse período;
- : Define se o token tem permissão para criar dados (chamados, clientes, etc) ou alterar dados existentes (responder chamado, alterar cliente, modificar campos personalizados, etc).
- Token: Este valor é o token que deve ser usado para chamadas na API. Ele é gerado pelo sistema após a criação do token e não pode ser alterado.