Was sind API-Seiten in Microsoft Dynamics 365 Business Central?

October 26, 2025 · Andreea Arseni · Microsoft-Dynamics-Integration

Microsoft Dynamics 365 Business Central bietet ein leistungsstarkes API-Framework, das eine nahtlose Integration mit anderen Systemen und Anwendungen ermöglicht. Daten aus API-Seiten in Business Central zu lesen, ist eine häufige Anforderung für Unternehmen, die Prozesse automatisieren, Daten konsolidieren oder Business Central mit Anwendungen von Drittanbietern verbinden möchten. Dieser Artikel erklärt ausführlich, was API-Seiten in Business Central sind und wie Sie mit ihnen arbeiten.

Inhaltsverzeichnis

1. Was sind API-Seiten in Business Central?
2. Welche Vorteile bieten API-Seiten in Business Central?
3. Warum API-Seiten statt OData-Seiten in Business Central?
4. Wie steigen Sie in die Business Central APIs ein?
   1. API-Zugriff einrichten
   2. API-Seiten erkunden
5. So lesen Sie Daten aus API-Seiten
   1. GET-Anfrage senden
   2. Daten filtern und abfragen
6. Welche Best Practices gelten für das Lesen von API-Seiten?
7. Typische Anwendungsfälle für das Lesen von API-Seiten
8. Wie integrieren Sie Business Central API-Seiten mit Rapidi?
9. Fazit
10. FAQ

Was sind API-Seiten in Business Central?

API-Seiten sind eine Art von Webservice-Endpunkten in Business Central, über die externe Systeme mit den in der Anwendung gespeicherten Daten interagieren können. Diese Seiten stellen Business Central-Daten in einem strukturierten Format bereit, in der Regel als JSON, und erleichtern so die Integration mit anderen Anwendungen über HTTP-Anfragen.

API-Seiten in Business Central unterscheiden sich von Standardseiten, da sie für den programmgesteuerten Zugriff und nicht für die Bedienung durch Benutzer konzipiert sind.

Welche Vorteile bieten API-Seiten in Business Central?

API-Seiten in Business Central bieten mehrere Vorteile, die sie für Unternehmen zu einem unverzichtbaren Werkzeug machen:

1. Standardisierter Zugriff: Sie bieten einen einheitlichen und zuverlässigen Zugriff auf Business Central-Daten nach REST-Prinzipien, was die Integration mit modernen Anwendungen und Systemen vereinfacht.
2. Echtzeitdaten: API-Seiten ermöglichen den Zugriff auf Business Central-Daten in Echtzeit, sodass verbundene Anwendungen stets über die aktuellsten Informationen verfügen.
3. Anpassbar und erweiterbar: Entwickler können eigene API-Seiten erstellen, die auf spezifische Geschäftsanforderungen zugeschnitten sind, und gewinnen so Flexibilität und Skalierbarkeit.
4. OData-Unterstützung: Mit OData-Abfrageparametern lassen sich Daten filtern, sortieren und seitenweise abrufen, was den Datenabruf effizient und leistungsoptimiert macht.
5. Plattformübergreifende Kompatibilität: Business Central APIs lassen sich mit einer Vielzahl von Programmiersprachen und Tools nutzen und ermöglichen so die Integration mit Cloud-Diensten, mobilen Apps und Desktop-Lösungen.
6. Sichere Kommunikation: Die APIs unterstützen OAuth 2.0-Authentifizierung und HTTPS-Protokolle und gewährleisten so einen sicheren Zugriff auf sensible Daten.

Diese Vorteile machen API-Seiten zur idealen Wahl für Unternehmen, die ihre Konnektivität verbessern, Abläufe optimieren und fundiertere datenbasierte Entscheidungen treffen möchten.

Warum API-Seiten statt OData-Seiten in Business Central?

Sowohl API-Seiten als auch OData-Seiten dienen in Business Central als Webservice-Endpunkte, doch API-Seiten bieten gegenüber OData-Seiten klare Vorteile:

1. Speziell für die Integration entwickelt: API-Seiten sind ausdrücklich für den programmgesteuerten Zugriff und die Integration zwischen Systemen konzipiert. Sie stellen nur die wesentlichen Felder und Funktionen bereit, was die Komplexität reduziert und die Leistung steigert.
2. Bessere Leistung: API-Seiten sind schlanker und für Integrationsszenarien besser optimiert als OData-Seiten, die aufgrund ihres breiteren Umfangs und ihrer größeren Flexibilität zusätzlichen Overhead verursachen können.
3. Versionierung und Erweiterbarkeit: Das API-Framework von Business Central unterstützt Versionierung, sodass Entwickler bei Aktualisierungen die Abwärtskompatibilität wahren können. Bei OData-Diensten ist diese Funktion weniger ausgereift.
4. Konsistenz über Umgebungen hinweg: API-Seiten bieten eine einheitliche und vorhersehbare Struktur und eignen sich daher besser für moderne Entwicklungspraktiken und Tools, die RESTful APIs erwarten.
5. Integrierte Authentifizierung und Sicherheit: API-Seiten nutzen OAuth 2.0 und entsprechen modernen Sicherheitsstandards besser als herkömmliche OData-Endpunkte, die für ein vergleichbares Sicherheitsniveau unter Umständen zusätzliche Konfiguration erfordern.
6. Kompatibilität mit dem Ökosystem: Viele Tools von Drittanbietern, Middleware-Lösungen und Integrationsplattformen sind für REST APIs optimiert, wodurch API-Seiten besser mit externen Systemen kompatibel sind.

Für Unternehmen, bei denen Integrationen, Skalierbarkeit und Leistung im Vordergrund stehen, sind API-Seiten in der Regel die bessere Wahl gegenüber OData-Seiten.

Wie steigen Sie in die Business Central APIs ein?

1. API-Zugriff einrichten

Bevor Sie auf API-Seiten zugreifen, stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind:

• Authentifizierung: Richten Sie die OAuth 2.0-Authentifizierung für einen sicheren API-Zugriff ein. Dafür wird häufig Azure Active Directory (AAD) verwendet.
• Benutzerberechtigungen: Stellen Sie sicher, dass der Benutzer, der auf die API zugreift, über die entsprechenden Berechtigungen verfügt. Weisen Sie in Business Central die erforderlichen Rollen zu, um Zugriff auf die Daten zu gewähren.

Struktur der API-URL:

Business Central stellt zwei Haupttypen von Endpunkten bereit:

• OData-Endpunkte (Legacy) unter /ODataV4/
• Moderne Business Central API-Endpunkte unter /api/v2.0/

Die empfohlene Struktur für die API-Seiten von Business Central lautet:

https://api.businesscentral.dynamics.com/v2.0/<tenant_id>/<environment_name>/api/v2.0/

Beispiel – Mandanten abrufen:

https://api.businesscentral.dynamics.com/v2.0/<tenant_id>/<environment_name>/api/v2.0/companies

Der Pfad /api/v2.0/ ist versioniert und für Integrationen optimiert, während /ODataV4/ für OData-Webservices verwendet wird, die in Business Central erstellt wurden.

2. API-Seiten erkunden

Microsoft stellt eine Vielzahl vordefinierter API-Seiten bereit, die Sie direkt nutzen können. Beispiele:

• Companies: Ruft Details zu den Mandanten in Business Central ab.
• Customers: Ruft Debitoreninformationen ab.
• Items: Liefert Details zu Lagerartikeln.

Verfügbare APIs ermitteln

Um alle verfügbaren API-Seiten in Ihrer Umgebung aufzulisten, können Sie eine GET-Anfrage an folgende Adresse senden:

https://api.businesscentral.dynamics.com/v2.0/<tenant_id>/<environment_name>/api/v2.0/

Sie erhalten einen Katalog aller veröffentlichten API-Endpunkte, einschließlich ihrer Entitätsnamen und Versionsnummern.

Weitere Informationen finden Sie in der Business Central API-Dokumentation von Microsoft.

So lesen Sie Daten aus API-Seiten

Daten aus einer API-Seite zu lesen, ist einfacher, als Sie denken: Sie müssen lediglich eine HTTP-GET-Anfrage senden. Das Verfahren ist unkompliziert, und Sie werden schnell damit vertraut sein. Beachten Sie jedoch: Mit Rapidi müssen Sie HTTP-Anfragen nicht manuell verarbeiten – die Anbindung an API-Seiten ist bereits integriert. Geben Sie in der Einrichtung Ihrer Rapidi-Verbindung die richtige Endpunkt-URL an, und Rapidi liest und verarbeitet die Daten aus der Business Central API automatisch.

1. GET-Anfrage senden

Um Daten aus einer API-Seite zu lesen, verwenden Sie eine HTTP-GET-Anfrage.

Beispielanfrage:

https://api.businesscentral.dynamics.com/v2.0/<tenant_id>/<environment>/api/v2.0/companies

Antwort:

{
  "value": [
    {
      "id": "12345678-1234-1234-1234-1234567890ab",
      "name": "Cronus International Ltd.",
      "address": "1234 Main St",
      "city": "London",
      "country": "UK"
    }
  ]
}

2. Daten filtern und abfragen

Die Business Central APIs sind so konzipiert, dass Sie die Kontrolle behalten. Sie unterstützen OData-Abfrageparameter vollständig, sodass Sie Daten nach Bedarf filtern, sortieren und seitenweise abrufen können.

Beispiel mit Filter:

https://api.businesscentral.dynamics.com/v2.0/<tenant_id>/<environment>/api/v2.0/customers?$filter=displayName eq 'CRONUS International Ltd.'

Welche Best Practices gelten für das Lesen von API-Seiten?

1. APIs absichern: Verwenden Sie immer HTTPS und geeignete Authentifizierungsmethoden wie OAuth 2.0, um API-Endpunkte abzusichern. So sind Ihre Daten jederzeit sicher und geschützt.
2. Abfragen optimieren: Verwenden Sie OData-Abfrageparameter wie $filter, $select und $top, um die zurückgegebenen Daten zu begrenzen und die Größe der Nutzdaten zu verringern.
3. Drosselung berücksichtigen: Business Central begrenzt die Anzahl der API-Anfragen. Wenn Sie die Antwort 429 Too Many Requests erhalten, implementieren Sie Wiederholungsversuche mit exponentiellem Backoff.
4. API-Nutzung überwachen: Überwachen Sie die API-Nutzung regelmäßig, um sicherzustellen, dass sie Ihrer Business Central-Lizenzierung entspricht und die Limits nicht überschreitet.

Typische Anwendungsfälle für das Lesen von API-Seiten

1. Datenintegration: Synchronisieren Sie Business Central-Daten mit anderen ERP-Systemen, CRM-Systemen oder individuellen Anwendungen.
2. Reporting: Extrahieren Sie Daten für externe Reporting-Tools wie Power BI oder Tableau.
3. Automatisierung: Automatisieren Sie Workflows, indem Sie Echtzeitdaten aus Business Central abrufen.

Wie integrieren Sie Business Central API-Seiten mit Rapidi?

Rapidi ist vollständig kompatibel mit den API-Seiten von Business Central, sodass Unternehmen Business Central mit anderen Systemen wie Salesforce, HubSpot oder Legacy-ERP-Systemen verbinden können.

Anders als ältere OData-Webservices sind API-Seiten in Business Central REST-basiert und schlank und damit ideal für Integrationen mit hohem Datenvolumen und in Echtzeit.

Rapidi kann Daten direkt über diese API-Endpunkte lesen und schreiben und beherrscht dabei Funktionen wie Filterung, Paginierung und Delta-Logik.

Diese Kompatibilität ermöglicht die nahtlose Synchronisierung von Tabellen oder Datenentitäten wie Debitoren, Artikeln oder Verkaufsaufträgen – bei gleichbleibender Sicherheit und Leistung.

Fazit

Das Lesen von API-Seiten in Business Central ist eine wichtige Fähigkeit für Unternehmen, die ihr ERP-System voll ausschöpfen möchten. Mit der richtigen Einrichtung und bewährten Vorgehensweisen können Sie effizient auf Ihre Daten in Business Central zugreifen und das Beste aus ihnen herausholen, um Integrationen, Reporting und Automatisierung voranzutreiben.

Aktualisiert im Januar 2026

Häufig gestellte Fragen (FAQ)

Authentifizierung & Einrichtung

API-Endpunkte & Struktur

Filtern & Abfragen

Fehlerbehandlung & Ratenlimits

Benutzerdefinierte APIs

Fehlerbehebung