Business Central propose pas moins de 80 APIs standards (Cf. API (V2.0) for Dynamics 365 Business Central – Business Central | Microsoft Learn).
Vous devriez y trouver votre bonheur… ou presque, car, la principale contrainte des API standards est qu’elles ne sont pas extensibles (ce qui n’est pas surprenant puisqu’une API définit un contrat et que toute modification de celui-ci devrait être assortie d’une incrémentation de sa version).
Ainsi, qu’il s’agisse d’une information standard non exposée ou d’un champ spécifique, vous ne pourrez ni le lire ni le mettre à jour par ces APIs 🙁
Voyons comment arriver à nos fins.
Cet article prolonge la série « Bienvenue dans le monde merveilleux des APIs ».
Si vous avez raté les épisodes précédents, il n’est pas trop tard pour bien faire : API et intégration – Wanamics
Pour mémoire, l’API des APIs permet d’en obtenir la liste (Cf. Finies les interfaces, vive les connecteurs – Wanamics ainsi que la collection Postman Partagée par Christian).
La solution de contournement consiste à dupliquer la partie exposée de l’API pour l’ajuster à vos besoins tout en préservant les fonctions standards sous-jacentes (qui pourront quant à elles bénéficier des extensions).
Arend-Jan Kauffmann (alias AJ, le gourou des API de Business Central) a publié 2 articles détaillés à cet effet :
Extending standard APIs (1) – Kauffmann @ Dynamics 365 Business Central
Extending standard APIs (2) – Kauffmann @ Dynamics 365 Business Central
Il est également coauteur du livre : Microsoft Dynamics 365 Business Central API Reference – Spare Brained Ideas.
Vous trouverez les sources des APIs standards sur ALAppExtensions/Apps/W1/APIV2 at main · microsoft/ALAppExtensions · GitHub
Sachez aussi que l’incontournable PostMan, accessible en ligne ou installé sur votre poste de travail, est également disponible au sein de VS Code (voir Postman – Visual Studio Marketplace).
Introducing the Postman VS Code Extension | Postman Blog
Postman Extension: Fastest Way To Test Business Central APIs – Business Central Geek
Et pour manipuler le format json vous disposez d’outils tels que https://jsonformatter.org/ ou d’Excel qui dispose également de fonctions à cet effet, bien décrites sur la page How to Convert a JSON File to Microsoft Excel (howtogeek.com).
Les articles suivants pourront également vous éclairer :
HttpClient Data Type – Business Central | Microsoft Learn
What Are Bound Actions In Business Central APIs – Business Central Geek
How To Connect To External APIs From Business Central (HTTP Request) – Business Central Geek
Exemple API customerPayments + _AppliesToId, _BalAccountType, _BalAccountId,
Pour information, la validité par défaut du token est de 1 heure (Using OAuth to Authenticate Business Central Web Services (OData and SOAP) – Business Central | Microsoft Learn).
Commentaires récents