Aller au contenu principal

Autorisation

L'API d'autorisation fournit des tokens pour accéder de manière sécurisée à la plateforme Meister1. Utilisez un access token pour authentifier les requêtes API, un refresh token pour renouveler la session et l'URL de grant SSO pour connecter les utilisateurs de manière transparente.

AccessToken​

info

L'accès à l'API nécessite une clé API. Générez-la dans le portail client Meister1 :

  1. Cliquez sur votre nom d'utilisateur en haut à droite.
  2. Ouvrez Utilisateurs et accès.
  3. Faites défiler jusqu'à la section API Keys et générez une nouvelle clé.

Vous recevez un identifiant de clé (clientId) et un secret (clientSecret). Le secret n'est affiché qu'une seule fois lors de la création – conservez-le en lieu sûr.

Exemple de requête​

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

Exemple de réponse​

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

RefreshToken​

Exemple de requête​

curl --location 'https://app.meister1.com/auth/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'

Exemple de réponse​

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

URL d'octroi SSO​

Exemple de requête​

curl --location 'https://app.meister1.com/auth/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'

Exemple de réponse​

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

Le grantUrl n'est valide que pendant 15 secondes.