Autenticação e acesso

Uma chave identifica uma integração

Um administrador gere as chaves em API e integrações. Uma chave pertence a um grupo, não a um colaborador. É possível criar várias chaves nomeadas, definir validade, substituí-las e revogá-las. O segredo completo é apresentado uma vez; depois, a interface mostra apenas o prefixo e metadados de utilização. Guarde-o no cofre de segredos do servidor, nunca num navegador ou aplicação móvel.

Envie a chave em todos os pedidos da integração:

Authorization: Bearer YOUR_API_KEY

No campo Bearer Token do Scalar, cole apenas a chave. O Scalar acrescenta Bearer automaticamente; não repita o prefixo.

Não existe login de parceiro nem troca de refresh token. O TrakarIA valida chave, permissões, estado da organização e acesso comercial. Uma chave revogada ou expirada deixa de funcionar. Use chaves distintas por sistema para as poder rodar separadamente.

Cada operação exige uma permissão como vehicles:read ou inspections:write. Escolha o mínimo na referência de permissões.

Uma ligação de abertura continua a exigir uma pessoa

A chave autentica o software. A ligação identifica a inspeção, mas o colaborador também se autentica no TrakarIA. Não coloque a chave no URL. As ligações têm curta duração e podem ser renovadas pela API.

Endereço da API

Envie pedidos para https://api.trakaria.com. GET /v1/capabilities mostra funcionalidades e limites efetivos. Pode começar por um pedido só de leitura antes de criar dados.