Authenticatie en toegang

Eén sleutel identificeert één integratie

Een beheerder beheert API-sleutels via API & integraties. Een sleutel hoort bij een groep, niet bij een medewerker. Je kunt meerdere benoemde sleutels maken, een vervaldatum instellen, vervangen en intrekken. Het volledige geheim wordt één keer getoond; later toont de interface alleen prefix en gebruiksmetadata. Bewaar het in een server-side secret store, nooit in een browser of mobiele app.

Stuur de sleutel bij elke partneraanvraag:

Authorization: Bearer YOUR_API_KEY

Plak in Scalar bij Bearer Token uitsluitend de sleutel. Scalar voegt Bearer automatisch toe; plaats daar geen tweede prefix.

Er is geen partnerlogin of refresh-tokenuitwisseling. TrakarIA controleert sleutel, rechten, organisatiestatus en commerciële toegang. Een ingetrokken of verlopen sleutel werkt niet meer. Gebruik aparte sleutels per systeem, zodat je ze onafhankelijk kunt roteren.

Elke bewerking vereist een specifiek recht, bijvoorbeeld vehicles:read of inspections:write. Kies de minimale set via de referentie voor API-sleutelrechten.

Een startlink vereist nog steeds een persoon

De sleutel authenticeert software. De link identificeert de inspectie die moet worden geopend, maar de medewerker authenticeert zich ook in TrakarIA. Plaats de API-sleutel nooit in de URL. Startlinks zijn tijdelijk en kunnen via de API worden vernieuwd.

API-adres

Stuur aanvragen naar https://api.trakaria.com. GET /v1/capabilities toont effectieve functies en limieten. Begin eventueel met de alleen-lezen aanvraag voordat je gegevens maakt.