Mit API-Begrenzungen arbeiten

Abgeschlossen

Um die Leistung der Business Central SaaS-Server zu verwalten, beschränkt Microsoft die Verwendung der API. Beachten Sie diese Einschränkungen, damit Sie Ihren Code beim Herstellen einer Verbindung mithilfe der API optimieren können. Einschränkungen gelten auch für OData‑ und SOAP-Webdienste. Es gibt die folgenden Beschränkungen:

  • Anzahl der Anforderungen In der Sandbox-Umgebung können Sie maximal 300 Anforderungen pro Minute senden. Die Produktionsumgebung enthält maximal 600 Anforderungen pro Minute.

  • Ein Timeout tritt auf, wenn Ihre Anfrage mehr als 10 Minuten Laufzeit hat.

  • Die maximale Zahl gleichzeitiger Anforderungen ist 100.

  • Eine Seite kann nur 20000 Entitäten für jede Seite enthalten.

  • Das Betriebs-Timeout beträgt acht Minuten.

Verwenden Sie die folgenden Ansätze, um die Anzahl der Anrufe von einem Client oder einer Integration und die Laufzeit zu verringern:

  • Webhooks sollten Änderungen erhalten, wenn sie auftreten. Ihre Anwendung kann eine Push-Nachricht erhalten, wenn eine Entität geändert wird, anstatt dass Sie alle paar Minuten nach Änderungen suchen müssen. Versuchen Sie, Ihre Lösung von einem Pull‑ in ein Push-Modell umzuwandeln. Wenn diese Option nicht möglich ist, können Sie andere Empfehlungen anwenden.

  • Verwenden Sie die Stapelverarbeitung, um mehrere Vorgänge in einem Aufruf auszuführen.

  • Verwenden Sie den OData-Filterausdruck $filter, um die Anzahl der zurückgegebenen Entitäten zu reduzieren.

  • Verwenden Sie den OData-Filterausdruck $expand zum Abrufen verwandter Entitäten in einer Anforderung.

  • Wenn Sie Daten veröffentlichen, können Sie auch deep inserts verwenden. Sie können Details in einer Anfrage senden. Wenn Sie einen neuen Verkaufsauftrag erstellen, können Sie alle Ihre Verkaufszeilen in derselben POST-Anfrage senden und in einem Aufruf erstellen lassen.