Authenticatie

Alle Tarasa REST API-endpoints vereisen authenticatie. Er zijn drie manieren om je te authenticeren. In alle drie de gevallen moet de Host-header het klantdomein bevatten — dit bepaalt op welke applicatie de request wordt uitgevoerd.

API-sleutel

De aangeraden manier voor server-to-server integraties. De API-sleutel wordt gegenereerd in de Admin UI en gekoppeld aan een gebruiker met een specifieke rol.

GET /api/data/v2/Visit HTTP/1.1
Host: klant.apps.tarasa.io
Authorization: ApiKey 123-xyz-456

Basic authentication

Voor gebruikers met een gebruikersnaam en wachtwoord. De rechten van de geauthenticeerde gebruiker bepalen wat de request mag doen.

Authorization: Basic <base64(username:password)>

Inloggen via /api/user-access/authenticate

Bedoeld voor interactieve sessies (bijvoorbeeld een web-frontend), niet relevant voor server-to-server integraties.