Verwenden Sie diesen Endpunkt, um ein IDMobile-Zugriffstoken zu generieren. Das Token wird benötigt, um alle anderen IDMobile-Scope-Endpunkte aufzurufen.
Verwandte ID-Mobile-Dokumentation:
GET-Anfrage
https://{SERVER_ADDRESS}/ACCESS_TOKEN/?client_secret={CLIENT_SECRET}&grant_type=client_idmobile&licence={LICENCE_CODE}Ersetzen Sie die Werte in geschweiften Klammern durch Ihre eigenen Informationen:
| Parameter | Beschreibung | Pflicht/Optional |
|---|---|---|
| SERVER_ADDRESS | Adresse des DQE-Servers, der die Daten verarbeitet. | Pflicht |
| licence | Ihnen als Lizenzcode zugewiesene Nummer. | Pflicht |
| client_secret | Vom Kunden bereitgestellte Passphrase. | Pflicht |
| grant_type | Statischer Wert. Muss client_idmobile sein. |
Pflicht |
POST-Anfrage
https://{SERVER_ADDRESS}/ACCESS_TOKEN/Fügen Sie die folgenden Parameter im Anfragetext mittels x-www-form-urlencoded hinzu:
| Parameter | Beschreibung | Pflicht/Optional |
|---|---|---|
| licence | Ihnen als Lizenzcode zugewiesene Nummer. | Pflicht |
| client_secret | Vom Kunden bereitgestellte Passphrase. | Pflicht |
| grant_type | Statischer Wert. Muss client_idmobile sein. |
Pflicht |
Antwort
Erfolg
Die API gibt ein JSON-Objekt mit den folgenden Schlüsseln zurück:
| Schlüssel | Beschreibung | Typ |
|---|---|---|
| access_token | Temporäres Token zum Aufrufen der IDMobile-Dienste. | STRING |
| token_type |
Bearer: der autorisierte Tokentyp. |
STRING |
| expires_in | Gültigkeitsdauer des Tokens, in Sekunden. | STRING |
| refresh_token | Token zur Verlängerung Ihrer Sitzung. | STRING |
Beispiel:
{
"access_token": "TK948869a6f873adb622enhoaGeVY2iRaptqlmpplGeWZA",
"token_type": "Bearer",
"expires_in": "300",
"refresh_token": "*TK9bdd05f8e9d3c905834bdeqaUlGFll2iRaplll29mZmtkZQ"
}Fehler
| Fehlertyp | Beispielanfrage | Antwort |
|---|---|---|
Fehlender Parameter licence
|
https://{SERVER_ADDRESS}/ACCESS_TOKEN/?client_secret=abcd&grant_type=client_idmobile |
400-Fehler (Invalid Request) |
Leerer Parameter licence
|
https://{SERVER_ADDRESS}/ACCESS_TOKEN/?client_secret=abcd&grant_type=client_idmobile&licence= |
400-Fehler (Invalid Request) |
Falscher Wert für licence
|
https://{SERVER_ADDRESS}/ACCESS_TOKEN/?client_secret=abcd&grant_type=client_idmobile&licence={INCORRECT_LICENCE_CODE} |
400-Fehler (Invalid Client) |
Fehlender oder leerer client_secret
|
https://{SERVER_ADDRESS}/ACCESS_TOKEN/?grant_type=client_idmobile&licence={LICENCE_CODE} |
400-Fehler (Invalid Request) |
Fehlender oder falscher grant_type
|
https://{SERVER_ADDRESS}/ACCESS_TOKEN/?client_secret=abcd&licence={LICENCE_CODE} |
400-Fehler (Invalid Request) |
| Tippfehler im Parameter | https://{SERVER_ADDRESS}/ACCESS_TOKEN/?client_scret=abcd&grant_type=client_idmobile&licence={LICENCE_CODE} |
500-Fehler |