Authentifizierung und Token-Aktualisierung

Um die Blink API zu nutzen, müsst ihr euch mit einem Bearer-Access-Token (id_token) authentifizieren. Ihr erhaltet dieses Token, indem ihr eine Anfrage an den Authentifizierungs-Endpunkt sendet, zusammen mit eurem Benutzernamen ([USERNAME]), Passwort ([PASSWORD]) und Systemnamen ([SYSTEM]).

Bearer-Access-Token anfordern

Anfrage (Curl)

Bash

curl --location 'https://[SYSTEM]-api.blink.online/api/v2/auth' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data-raw '{  
   "AuthMode": "Pwd", 
   "Username": "[USERNAME]",
   "Password": "[PASSWORD]",  
   "Device": { 
     "Number": "[SYSTEM]",
     "Type": "AzureFunction",
     "DeviceInfo": "[SYSTEM]"
   } 
 }'

Antwort (JSON)

JSON

{
    "id_token": "eyJhbGciOi...",
    "access_token": null,
    "token_type": "bearer",
    "refresh_token": "eyJhbGciOi...."
}

Beachtet, dass Bearer-Access-Tokens nur 24 Stunden gültig sind. Danach müsst ihr ein neues Token anfordern. Dies sollte über das Refresh-Token ([REFRESH_TOKEN]) und den Systemnamen ([SYSTEM]) erfolgen (siehe unten).

Neues Bearer-Access-Token über Refresh-Token anfordern

Anfrage (Curl)

Bash

curl --location 'https://[SYSTEM]-api.blink.online/api/v1/Token/Refresh?refreshToken=[REFRESH_TOKEN]' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data-raw '{
    "Number": "[SYSTEM]",
    "Type": "AzureFunction",
    "DeviceInfo": "[SYSTEM]"
}'

Antwort (JSON)

JSON

{
    "id_token": "eyJhbGciOi...",
    "expires_in": 1706686564,
    "refresh_token": "eyJhbGciOi..",
    "access_token": null,
    "token_type": "Bearer"
}

Verwendet das Bearer-Access-Token ([ID_TOKEN]) für alle Anfragen an die Blink API.

Bearer-Access-Token in beliebigen Anfragen verwenden

Beispiel GET-Anfrage (Curl)

Bash

curl --location 'https://[SYSTEM]-api.blink.online/odata/v2/Locations' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer [ID_TOKEN]'

Beispiel POST-Anfrage (Curl)

Bash

curl --location 'https://[SYSTEM]-api.blink.online/odata/v2/Locations' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer [ID_TOKEN]' \
--data-raw '{ ... }'