Authentification

OAuth 2.0
L'accès à l'API nécessitera une authentification OAuth 2.0 qui, à son tour, nécessitera un utilisateur technique pour un distributeur particulier dans le système d'authentification Schneider.
Pour demander des informations d'identification, veuillez envoyer un e-mail à : distributorapiportal.global@se.com

Comment fonctionne OAuth :

1. L'utilisateur de l'API doit disposer d'un ID client statique et d'une clé secrète, ainsi que du point de terminaison de génération de jeton du fournisseur d'API.
2. En utilisant les détails ci-dessus, l'API Token doit être appelée avec la méthode POST.
3. Cette API renverra le jeton Bearer, qui peut être utilisé pendant 1 heure pour appeler l'API, cela peut être traité comme un identifiant dynamique qui a une expiration d'une heure.

Comment générer un jeton à l'aide de Postman :

1. Créer une nouvelle demande d'API avec le point de terminaison d'API réel
2. Aller à la section Autorisation
3. Sélectionnez Type comme OAuth 2.0
4. Sur le côté droit, accédez à Configurer un nouveau jeton
5. Le nom du jeton peut être défini par l'utilisateur (par exemple, le nom du distributeur)
6. Grant Type = Client Credentials (Sélectionner dans le menu déroulant)
7. L'URL du jeton d'accès sera conforme au tableau ci-dessus
8. L'ID client et le secret client seront donnés par l'équipe Schneider
9. Portée tout
10. L'authentification du client peut être Envoyer les informations d'identification du client dans le corps
11. Cliquez sur Obtenir un nouveau jeton d'accès

Exemple de génération de jeton à l'aide de la nouvelle requête Postman :

1. Sélectionnez POST et entrez l'URL du jeton.
2. Dans l'onglet Corps, cliquez sur le bouton radio x-www-form-urlencoded.
3. Entrez manuellement la clé et la valeur, "grant_type" et "client_credentials".
4. Dans l'onglet Autorisation, sélectionnez Type "Basic Auth".
5. Définissez le nom d'utilisateur sur la clé client (qui vous est fournie hors ligne).
6. Définissez le mot de passe sur le secret client (qui vous est fourni hors ligne).
7. Envoyez la demande et récupérez la valeur de access_token à partir du message de réponse.

Création de demande de génération de jeton à l'aide de CURL dans Postman :

1. Dans Postman, sélectionnez l'option Importer (qui se trouve en haut à gauche).
2. Dans la boîte de dialogue Importer, sélectionnez Texte brut et collez l'exemple de curl fourni ci-dessous.
3. Cliquez sur Continuer puis sur Importer.
4. Dans l'onglet En-têtes, remplacez la valeur d'autorisation par la chaîne encodée en base 64 de client_key et client_secret.

 
Exemple de curl pour la génération de jetons :
curl --location --request POST 'https://api.se.com/token' \
--header 'Authorization: Basic askjdfsaldalskjfdlsajflasdkjfb2h4NVJxMFlSZ2hUbA==' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials'

Clé API
Pour quelques API, l'accès à l'aide de la clé API est également possible lorsque vous fournissez l'apikey de longue durée en tant que paramètre de requête.
Une fois que vous avez une clé API, vous pouvez exécuter des opérations GET directement dans un navigateur Web.
Format d'URL : https://{hostname}/{BaseURL}/{ResourcePath}?{queryParams}&apikey={your_api-key}