Faire votre premier appel
Dans le reste de cette documentation, nous utiliserons l'outil Postman pour nous authentifier et nous connecter à une API Cegos.Si vous ne l'avez pas, vous pouvez le télécharger depuis le site officiel.Vous pouvez également utiliser tout autre outil de votre choix.
S'authentifier
Avant de faire une requête à une API, vous devez vous identifier et obtenir un token. Lancez Postman, créez une nouvelle requête et allez dans l'onglet "Authorization".Sélectionnez Oauth 2.0 et saisissez les valeurs suivantes :
Grand Type : client CredentialsAccess Token URL : https://api.cegos.fr/connect/tokenClient Id : your_client_idClient Secret : your_client_secretScope : api-cegosClient Authentication : Send client credentials in body
Comme dans l'exemple ci-dessous :
Cliquez sur "Get New Access Token".
Si votre requête est réussie, Postman affichera une nouvelle fenêtre avec les détails du token obtenu.
Cliquez sur "Use Token".Cette action vous permettra d'utiliser ce token lors de vos requêtes vers une API Cegos.
Le token est valide pendant 1 heure.
Appeler une API Cegos
Vous pouvez maintenant appeler une API Cegos. Pour notre exemple, nous allons récupérer l'arborescence des thèmes de formation disponibles sur le site Cegos.fr.
Nous allons faire un simple appel GET vers :https://catalog.api.cegos.fr/v1/CatalogsTopics
Aucun paramètre n'est requis pour cet appel. Vous obtiendrez une réponse JSON comme indiqué ci-dessous :
Vous êtes maintenant capable d'interagir avec nos API.