S'authentifier via la méthode client credentials

Cas d'utilisation

La méthode client credentials se limite exclusivement à des appels serveur à serveur.

Les étapes d'authentification

La méthode client_credentials permet d'obtenir un accès sans approbation d'un utilisateur final. Celui-ci est générique et non nominatif. N'ayant pas de validation de l'adéquation d'un identifiant et d'un mot de passe, cette méthode se limite à des utilisations ou le tiers (votre application) est capable de protéger les données d'enregistrement de l'application.

Voici les étapes générales :

• Etape 1 : Vous fournissez les informations liées à l'enregistrement de l'application
• Etape 2 : Vous recevez un access token

Etape 1 : Fournir les identifiants de l'application

Faire une requête POST à https://{api_base_url}/{client_token}/oauth/v2/token avec les paramètres suivants :

paramètre	localisation	description
api_base_url	Query	L'url de l'API que vous souhaitez utiliser. Celle-ci varie selon les environnements d'intégration et de production
client_token	Query	Chaque chaîne de club possède son identifiant Resamania appelé client_token
grant_type	Body	Le nom de la méthode, à renseigner à client_credentials
client_id	Body	Chaque application enregistrée possède un identifiant auprès du serveur OAuth nommé client_id
client_secret	Body	Chaque application enregistrée possède une chaîne secrète auprès du serveur OAuth nommé client_secret

Exemple d'appel

curl --location 'https://{api_base_url}/{client_token}/oauth/v2/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'client_id=123_xxxxxxxxxxxxxxxxx' \
--data-urlencode 'client_secret=******************' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'refresh_token=N2E2YzcwYWYxN...'

Etape 2 - Recevoir l'access token

L'API du serveur OAuth vous retourne en réponse les informations suivantes :

{  
   "access_token":"{access_token}",
   "expires_in":{expires_in},
   "token_type":"bearer",
   "scope":{scope},
   "refresh_token":"{refresh_token}"
}

paramètre	description
access_token	Le jeton JWT nécessaire à toute requête auprès l'API Resamania
expires_in	La durée en secondes de validité de l'access token
token_type	Le type d'access token qui pour Resamania est toujours à Bearer
scope	Le ou les scopes particuliers liés à l'access token
refresh_token	Le nouveau token de renouvellement d'accès