API, ma première requête

Pour expérimenter les APIs proposées par la version standard, nous utiliserons ici l’application Postman (téléchargez la version gratuite largement suffisante) qui permettra de formuler des requêtes et recueillir les réponses.

Les exemples proposés se basent sur la version cloud de Business Central (dont l’URL débute par https://api.businesscentral.dynamics.com ).

Authentification

Avant de pouvoir communiquer avec Business Central, il nous faut montrer patte blanche.

Plusieurs modes sont envisageables mais nous nous limiterons ici à l’authentification de base.

Mise à jour

Depuis la version 2023 wave 1, seule l’authentification OAuth2 proposée pour la solution SaaS (voir Montrez patte blanche avec OAuth2). L’authentification de base, bien que moins sécurisée, reste possible en ‘On premise’)

Depuis Business Central, recherchez ‘Utilisateurs’ puis sélectionnez le vôtre dans la liste.

Copiez le sésame « Clé d’accès service web ».

Remarque : s’il ne s’agit pas de votre utilisateur, ce sésame est masqué et ne peut être copié.

Postman

Ouvrez Postman, puis, à l ‘aide du ‘+’, créez une collection comme illustré ci-dessous.

L’action ‘Edit’ vous permet alors d’accéder à la configuration de cette collection :

Choisissez le « Type » Basic Auth’, indiquez votre « Username » et collez le sésame en « Password » (attention, il s’agit bien de la « Clé d’accès service web » copiée plus haut et non de votre mot de passe habituel).

Variables

Passez alors à l’onglet ‘Variables’ et déclarez le ‘tenantId’ qui figure dans votre URL d’accès à l’application (exemple : https://businesscentral.dynamics.com/e58e4362-4ba1-46f8-b9da-326a8fa42dc7/….)

Attention : veillez à respecter scrupuleusement les minuscules et les majuscules, tant dans les noms des variables que dans les valeurs.

Par convention les noms débutent par une minuscule et chaque mot suivant concaténé débute par une majuscule (ex : tenantId).

Ma première requête

Accédez au menu d’action de la collection (‘…’) pour ajouter une requête (Add request) :

Dans la zone de requête, copiez la ligne ci-après à côté du ‘GET’ :

https://api.businesscentral.dynamics.com/v2.0/{{tenantId}}/Production/api/v1.0/companies

Cliquez sur ‘Send’…. et si tout va bien, vous devriez voir s’afficher en « Response » la liste des sociétés :

Lien Permanent pour cet article : https://www.wanamics.fr/ma-premiere-requete/

1 ping

  1. […] Vous pourrez alors utiliser un service tel que PostMan pour tester les requêtes ci-après en ayant défini les variables concernées (Cf. API, ma première requête). […]

Laisser un commentaire