Przejdź do głównej zawartości

Autoryzacja

API autoryzacji dostarcza tokeny do bezpiecznego dostępu do platformy Meister1. Użyj tokenu dostępu do uwierzytelniania żądań API, tokenu odświeżającego do odnawiania sesji oraz adresu URL grantu SSO do bezproblemowego logowania użytkowników.

AccessToken​

informacja

Potrzebujesz użytkownika server.

Przykładowe żądanie​

curl --location 'https://auth.meister1.com/v1/token' \
    --header 'Content-Type: application/x-www-form-urlencoded' \
    --data-urlencode 'clientSecret=<SECRET>' \
    --data-urlencode 'clientId=<USERNAME>' \
    --data-urlencode 'grantType=client_credentials'

Przykładowa odpowiedź​

{
    "accessToken": "eyJhbGciOi1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyfDF8NDE5NiIsI6MTYczOTYxOTY0Nyk1NzAzNjE5NjQ3fQ._w7VfOIVqEoVEHkmmr4uYhU",
    "expiresIn": 36000,
    "tokenType": "Bearer",
    "refreshToken": "9b449928632c5877f.cik243fd-f5jdue612fed.ac4db1b6-27af-464d-867a-78ee21a0f.56048d69784"
}

RefreshToken​

Przykładowe żądanie​

curl --location 'https://auth.meister1.com/v1/token' \
    --header 'Content-Type: application/x-www-form-urlencoded' \
    --data-urlencode 'clientId=<EMAIL|USERNAME>' \
    --data-urlencode 'grantType=refresh_token' \
    --data-urlencode 'refreshToken=56a51ebws3f52.5914f61d-7d18-48b5-b9ea-c51d405791fe.f0b68e03-da10-4292-8154-8ee384b7e271.d982dws436d0ad34'

Przykładowa odpowiedź​

{
    "accessToken": "eyJhbGciOIsInR5cCI6IkpXVCJ9.eyWIiOiJ1c2VyfDF8NDE5NiIscCI6NTczOTYxOTY0Nyk1NzAzNjE5NjQ3fQ._w7VfOIVqEoVEHkmmr4uYhU",
    "expiresIn": 36000,
    "tokenType": "Bearer",
    "refreshToken": "92uk9926b6877f.f026-42d1-b8da-f5jdue612fed.ac4db1b6-867a-78ee21a0f.5fe2239048d69784"
}

SSO Grant Url​

Przykładowe żądanie​

curl --location 'https://auth.meister1.com/v1/sso' \
    --header 'Content-Type: application/x-www-form-urlencoded' \
    --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyfDF8ND4cCI6MTY5NTc2MTk1OTc5MCwiaWF0Ijojk1NzI1OTU5NzkwfQ.AaninWlbz4i807-azE9zxvEUkkkUrp3y40FZo' \
    --data-urlencode 'backUrl=https://www.beispiel.de/home' \
    --data-urlencode 'accountId=<ACCOUNT_ID>' \
    --data-urlencode 'locale=de-de'

Przykładowa odpowiedź​

{
    "grantUrl": "https://my.meister1.com/sso?token=72779b566415edd7185cbe87f2dw12a112fe1&userId=0001&timestamp=1695725988774&backUrl=https%3A%2F%2Fwww.beispiel.de%2Fhome&deepPath=%2Fcalculator%2FQ2FsY3YXRvcjoy",
    "expiresIn": 15
}
uwaga

grantUrl jest ważny tylko przez 15 sekund.