Autenticazione e accesso

Una chiave identifica un’integrazione

Un amministratore gestisce le chiavi nella pagina API e integrazioni. Una chiave appartiene a un gruppo, non a un singolo dipendente. È possibile creare più chiavi nominate, impostare o omettere una scadenza, sostituirle e revocarle. Il segreto completo viene mostrato una sola volta; in seguito l’interfaccia visualizza soltanto prefisso e metadati di utilizzo. Conservalo nel secret store del server, mai in un browser o in un’app mobile.

Invia la chiave a ogni richiesta API partner:

Authorization: Bearer YOUR_API_KEY

Nel campo Bearer Token di Scalar incolla soltanto la chiave. Scalar aggiunge automaticamente Bearer all’header HTTP; non inserire un secondo prefisso.

Non esiste un login partner né uno scambio di refresh token. TrakarIA verifica chiave, autorizzazioni, stato dell’organizzazione e accesso commerciale. Una chiave revocata o scaduta non può essere riutilizzata. Usa chiavi separate per sistemi separati, così da poterne ruotare una senza interrompere le altre.

Ogni operazione richiede un’autorizzazione precisa, per esempio vehicles:read o inspections:write. Consulta il riferimento delle autorizzazioni e assegna solo l’accesso minimo necessario.

Il collegamento richiede comunque una persona

La chiave autentica il software. Il collegamento identifica l’ispezione da aprire, ma il dipendente deve autenticarsi anche nell’interfaccia TrakarIA. Non inserire la chiave API nell’URL. I collegamenti hanno durata limitata e possono essere rinnovati tramite API.

Indirizzo API

Invia le richieste a https://api.trakaria.com. GET /v1/capabilities mostra funzioni e limiti effettivi per una chiave valida. Puoi iniziare con una richiesta in sola lettura prima di creare record nell’account.