Para integrar sua empresa com a API da plataforma Tractian, é necessário obter um token de autenticação. Esse token permite acesso seguro aos recursos da API e deve ser incluído nas requisições por meio do cabeçalho Authorization com o formato Bearer {seu_token}.
Abaixo explicamos os dois tipos de token disponíveis e como solicitar o seu.
Token associado ao usuário e à empresa
Esse tipo de token está vinculado diretamente a um usuário específico da sua empresa. Toda ação realizada via API será registrada com o nome desse usuário dentro da plataforma.
Exemplo:
“Usuário João Silva criou o ativo Teste Integração API”
Esse modelo é indicado para usos pontuais ou individuais, como:
Consultas para análise e testes
Registro em massa de ativos históricos durante uma migração de dados
Scripts pessoais de automação ou monitoramento
Recomendado quando a integração está sendo conduzida por um colaborador específico com necessidades temporárias ou pontuais.
Token associado apenas à empresa
Neste modelo, o token representa a empresa como um todo, sem vinculação a um usuário específico. As ações realizadas serão registradas com o nome da integração/API da empresa.
Exemplo:
“API da Empresa X adicionou um item ao inventário”
Esse token é mais adequado para integrações de sistemas que precisam operar continuamente e de forma automatizada, como:
Sistemas de compras integrados ao estoque da Tractian
Softwares de manutenção que criam ordens de serviço automaticamente
Soluções internas que atualizam dados de ativos de forma recorrente
Ideal para uso técnico em rotinas de integração entre sistemas corporativos.
Como solicitar o Token
Para solicitar um token de acesso, entre em contato com o time de suporte da Tractian. É importante informar:
Seus dados de contato
A finalidade de uso da API (exemplo: integração com sistema de compras, migração de ativos, dashboards internos etc.)
Após a solicitação, o token será gerado e enviado ao e-mail informado.
Observação importante: o uso da API está sujeito a custo adicional. Consulte o suporte para mais detalhes.
Como usar o Token
Assim que receber seu token, insira-o nas requisições HTTP no cabeçalho de autenticação:
Authorization: Bearer seu_token_aqui
Com isso, você já poderá começar a consumir os dados e recursos disponíveis na API da Tractian.