Erstauthentifizierung mit Benutzername/Passwort

Summary

• Creates an access token which can be used throughout the process
• Can be checked for expiry
• companyId is optional, API response contains all accessible companyIds
• Required API calls: authenticationService/authenticate

Request

Request POST to https://apis.alfaview.com/json/v1/authenticationService/authenticate

{
  "requestId": "### REQUEST ID ###",
  "usernamePasswordCredentials": {
  "username": "### USERNAME ###",
  "password": "### PASSWORD ###",
  "companyId": "### COMPANY ID ###"
  }
}

Response

{
  ...
  "accessToken": "...",
  "expiresAt": "...",
  ...
}

Notes

• Store the access token for subsequent requests
• Remember to re-authenticate before expiresAt timestamp, or you will receive an error that the token has expired