Obtenir un jeton d'accès (Access Token)

Le jeton d'accès est un code temporaire qui permet d'accéder aux API Cegid Expert.

Vous devez disposer d'une clé d'API (clé et secret) et de vos données de consommateur (ConsumerId et ConsumerSecret) pour obtenir un jeton d'accès.

Ci-dessous, un exemple d'appel au service d'authentification Cegid Expert SAAS Admin pour obtenir un jeton d'accès avec Postman :

Voici la même requête au format cURL :

curl --location 'https://cegid-expert-webapi-saasadmin.cegid.com/Oauth/Passport/ApiKey' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'client_Id=YourApiKey' \
--data-urlencode 'client_secret=YourApiKeySecret' \
--data-urlencode 'consumer_id=YourConsumerId' \
--data-urlencode 'consumer_secret=YourConsumerSecret' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'vendor_name=Vendor' \
--data-urlencode 'application_name=Application' \
--data-urlencode 'application_version=1.0'

Le retour prend la forme suivante :

Le jeton d'accès est valide pendant une heure.

Au dela de ce délai, vous devez en obtenir un nouveau en utilisant le jeton de renouvellement.
La durée de validité du jeton de renouvellement est de 8 heures.
Il peut être utilisé jusqu'à 10 fois.

Une documentation plus complète est disponible à l’adresse suivante : https://cegid-expert-developper.cegid.com/SaasAdmin.Passport/Ui/index.html

Important

Le jeton d'accès doit être transmis à chaque appel aux API Cegid Expert dans l'en-tête HTTP Authorization sous la forme Bearer {AccessToken}.