Die Joinpoints REST API verwendet eine tokenbasierte Authentifizierung. Du erzeugst in deinem Joinpoints Account zuerst einen API Key. Mit diesem API Key beantragst du anschließend einen Access Token. Der Access Token wird bei jedem API-Request als Bearer Token mitgeschickt.
Der Access Token wird über den Auth-Endpoint erstellt. Der genaue Request/Response ist in der Swagger-Dokumentation (siehe „API commands“) beschrieben.
Bei allen weiteren Requests sendest du den Token im Header:
Authorization: Bearer <ACCESS_TOKEN>
Bei allen weiteren Requests sendest du den Token als Parameter mit:
access_token = <ACCESS_TOKEN>
401/403 Token prüfen/erneuern und Berechtigungen kontrollieren200/201 – erfolgreich400 – ungültiger Request (z. B. Feldtyp passt nicht)401/403 – Token ungültig / keine Berechtigung404 – Ressource nicht gefunden500 – unerwarteter Serverfehler