Finies les interfaces, vive les connecteurs

Business Central dispose de nombreuses API natives qui sont autant de connecteurs avec d’autres applications.
Ces applications tierces peuvent dès lors exploiter les fonctions de Business Central ainsi ‘exposées’.

Ces connecteurs, utilisés par exemple pour l’intégration de Microsoft Sales (CRM) ou de Shopify (e-commerce), et mis à disposition via la Power Platform pour développer des applications « no-code, low-code » peuvent également être ‘consommés’ par toute autre application.

Nous avons déjà vu comment utiliser les données de Business Central depuis Excel via les « Services web » (voir Fin du confinement pour vos données) et ainsi, par une simple action « Actualiser », disposer de données fraîches.

Mais vous avez peut-être relevé la notification affichée depuis quelques temps sur la page concernée :

Les « Pages API » évoquées dans cette notification ne sont autres que les connecteurs décrits en introduction.

Mais, là où il vous suffisait de copier/coller « URL Odata V4 » en tant que source de données (dans Excel par exemple), il vous faut désormais la composer vous-même 🙁 ou les obtenir de votre prestataire préféré 🙂

La requête suivante vous permet de découvrir les APIs disponibles :
https://api.businesscentral.dynamics.com/v2.0/{{tenantID}}/{{environment}}/api/v2.0

Les termes entre {{ }} sont à remplacer par les valeurs vous concernant (en veillant à respecter minuscules/majuscules).
Vous les trouverez via l’action ‘?’ à la page « Aide et support » (« Abonné Azure AD » et « environnement » floutés dans l’exemple ci-dessous) :

Cette URL peut par exemple être utilisée via Excel pour afficher la liste des APIs disponibles (71 à ce jour) :

Vous fournissez cette URL comme source du « Flux OData » :

Si ce n’est déjà fait, vous devrez d’abord vous authentifier à l’aide d’un « Compte professionnel » par « Connection » et ensuite seulement « Se connecter » :

La plupart de ces APIs requièrent de cibler une société.

Dans un premier temps, vous pouvez compléter l’URL pour en obtenir la liste :
https://api.businesscentral.dynamics.com/v2.0/{{tenantId}}/{{Environment}}/api/v2.0/companies

Vous pourrez alors utiliser l’id de la société souhaitée pour compléter l’URL et préciser l’API concernée :
https://api.businesscentral.dynamics.com/v2.0/{{tenantId}}/{{Environment}}/api/v2.0/companies(fad6835c-df3a-ed11-bbab-000d3a38e33a)/customers

Ce ne sont là que les APIs standards de Business Central.

Les APIs décrites ci-dessus sont celles dites ‘v2.0’.

L’URL suivante donne la liste des ‘apiRoutes’ (publisher/group/version) :
https://api.businesscentral.dynamics.com/v2.0/{{tenantId}}/{{environmentName}}/api/microsoft/runtime/beta/companies({{companyId}})/apiRoutes

‘v2.0’ n’est que l’une de celles-ci.

Bienvenue dans le monde merveilleux des APIs 🙂

Voir aussi : Integration overview for Business Central – Business Central | Microsoft Learn