Um Anfragen einzelner Clients besser auswerten und fehlerhafte Anfragen analysieren zu können, wird empfohlen, mit jeder HTTP-Anfrage einen Client-Info-Header (Client-Info) mitzusenden. Diese Header-Information wird automatisch ausgewertet und im Anfrage-Log gespeichert.
Der Client-Info-Header sollte einen beschreibenden Namen der Anwendung enthalten, die die Anfrage ausführt. Zusätzliche Informationen können die Fehleranalyse erleichtern. Zum Beispiel kann auch die verwendete Version (z.B. 4.7.1) der Anwendung oder die verwendete Ausführungsplattform (Desktop, App oder Web) nützlich sein.
Beispiel Client-Info-Header gesendet vom Blink Manager
Anfrage (Curl)
Bash
curl --location 'https://[SYSTEM]-api.blink.online/odata/v2/Locations' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Client-Info: Blink Manager 4.7.1.203-WEB (hotfix/4.7.1)' \
--header 'Authorization: Bearer [ID_TOKEN]'