Une API page est un objet page Business Central de type API qui expose une table sous forme d'endpoint REST JSON, utilisé par les intégrations.
Une API page est un objet page Business Central déclaré avec le type API. Elle publie une table sous forme d'endpoint JSON en OData v4, avec un éditeur, un groupe, une version et un nom d'entité qui composent l'URL. Les API standard couvrent les entités courantes comme les clients, les fournisseurs, les articles et les factures, et un développeur peut ajouter ses propres API pages dans une extension AL.
Les API pages ne sont pas destinées à être ouvertes par un utilisateur, elles sont appelées par des applications. Côté Business Central, un administrateur autorise l'application appelante: recherchez avec Alt+Q la page qui liste les applications Microsoft Entra enregistrées, puis attribuez-lui les permission sets nécessaires. Les pages publiées en services web classiques figurent sur la page Web Services, alors qu'une API page livrée par une extension est disponible dès l'installation.
Une intégration lit les factures d'achat d'une société. Elle s'authentifie en OAuth, récupère l'identifiant de la société, puis appelle l'endpoint standard des factures d'achat avec un filtre sur le numéro de fournisseur, par exemple vendorNumber eq 'V10000'. La réponse est du JSON, un objet par facture, avec les champs exposés par l'API page et une valeur etag utilisée pour les mises à jour ultérieures.
Erreurs fréquentes: appeler un endpoint sans l'identifiant de société et ne rien trouver; envoyer une modification sans l'etag de l'enregistrement lu, que le service refuse pour éviter d'écraser le changement d'un autre; atteindre les limites de requêtes lors d'un chargement massif, ce qui renvoie une réponse de limitation que l'appelant doit réessayer après une pause. Côté développement, renommer une entité ou changer sa version modifie l'URL et casse tous les consommateurs, considérez les noms publiés comme figés.
Les API sont la voie supportée pour lire et écrire les données de Business Central depuis l'extérieur, et ce qu'une intégration peut atteindre reste limité par les droits du compte utilisé. Zentriq Agent et le connecteur Zentriq pour Claude et ChatGPT passent par cette couche en accès délégué: les réponses ne couvrent que les données lisibles par l'utilisateur connecté, et ce qu'ils créent arrive dans Business Central sous forme de brouillon soumis à validation.
Une page ou un codeunit publié en service web est exposé via les URL OData ou SOAP, tandis qu'une API page est un type de page dédié, avec un contrat JSON fixe et son propre chemin api. Pour une nouvelle intégration, l'API page est le choix recommandé.
Soit sous un utilisateur connecté en accès délégué, soit sous une application enregistrée. Dans les deux cas, le compte doit être autorisé dans Business Central et disposer des permission sets voulus avant de recevoir des données.
Les outils d'IA de Zentriq automatisent de nombreux processus manuels liés à api page (page api) dans Business Central. Découvrez l'Agent Zentriq ou essayez Zentriq PunchOut pour voir comment l'IA simplifie les achats dans BC.