Table of Contents

API aus Partnersicht

Business Central bietet - im Gegensatz zu vorangegangenen Produktgenerationen - OData-Services in Form von APIs an. Sie bieten u. a. folgende Vorteile gegenüber den bisher bekannten Webdiensten:

  • Partner erhalten individuelle Sichten

    • Partner erhalten separate APIs, die keine Endpunkte für andere Partner enthalten.
    • Die Unterteilungen sind über die unterschiedlichen Zugriffspfade klar erkennbar.
    • Auch die Selbstauskunft (Metadata) erfolgt je API separat, es kommt nicht mehr zu Vermischungen zwischen Endpunkten für unterschiedliche Partner.
  • parallele Versionen werden unterstützt

    • Der Server stellt in einer Übergangsphase mehrere Versionen gleichzeitig bereit, der Partner entscheidet, ab wann er die neue Version anspricht.
    • Mehrere Nutzer einer gemeinsamen API können individuell entscheiden, wie lange sie welche Version verwenden.
  • Programmierung statt Einrichtung

    • API-Pages werden nach klaren Konventionen programmiert und kompiliert. Damit sind unerwünschte indirekte Änderungen oder Deaktivierungen einzelner Webdienste ausgeschlossen.Navigationspfade zwischen logisch verknüpften Geschäftsobjekten werden automatisch je API kompiliert, aber nicht übergreifend zwischen den verschiedenen APIs.
    • Eine kontrollierte Namenskonvention sorgt für einheitliche, technologieübergreifend verwendbare Benennungen, die keine kritischen Zeichen enthalten.
  • einteiliger Primärschlüssel

    • Alternativ zu den meist sprechenden, mehrteiligen, mittels Rename änderbaren Primärschlüsseln nutzen APIs in der Regel die einteilige SystemId als Primärschlüssel.
    • Die sprechenden Primärschlüssel (z. B. Code-Felder) sind parallel weiterhin für geschäftslogische Zuordnungen (Kopf, Zeilen) und drilldownartige Erweiterungen nutzbar.
  • Webhooks

    • API-Pages erlauben optional die aktive Benachrichtigung über Datenänderungen in der Quelltabelle.
  • Standard- und Custom-APIs

    • Microsoft pflegt die Technologie strategisch auch zur eigenen Nutzung, sie ist für Standard- und Custom-APIs identisch. Aus diesen Gründen empfiehlt sich die Nutzung der API-Technologie auch für die Kommunikation mit Partnersystemen wie z. B. Webportalen.