Die REST-API-Falle: Warum Ihre Power Automate-Flows im großen Maßstab ausgebremst werden

Von Mirko Peters · 2026-08-11

Bei der Entwicklung von Lösungen im Microsoft 365-Ökosystem greifen Entwickler und Maker häufig auf bewährte, bequeme Muster zurück. REST ist für die meisten Power Platform-Entwickler die Standardwahl, birgt aber gefährliche Fallstolpersteine wie 429-Throttling und aufgeblähte Nutzlasten …

Automatisch mit KI aus dem Originalbeitrag übersetzt. Englisches Original lesen

Bei der Entwicklung von Lösungen im Microsoft 365-Ökosystem greifen Entwickler und Maker häufig auf bewährte, bequeme Muster zurück. REST ist für die meisten Power Platform-Entwickler die Standardwahl, birgt aber gefährliche Fallstolpersteine wie 429-Throttling und aufgeblähte Nutzlasten. Wenn Sie schon einmal erlebt haben, dass ein Power Automate-Flow in der Entwicklungsphase problemlos läuft und in der Produktion dann komplett ins Stocken gerät, kennen Sie wahrscheinlich die versteckten Kosten moderner Standardarchitekturen. Um Integrationen zu entwerfen, die produktiven Umfang bewältigen, ohne zusammenzubrechen, müssen wir über oberflächliche Bequemlichkeit hinausblicken und die grundlegenden Mechanismen zur Datenabfrage bewerten, die uns zur Verfügung stehen.

Dieser umfassende Leitfaden beleuchtet das Zusammenspiel von CAML, REST und JSON-Formatierung in Microsoft Lists und SharePoint. Wir analysieren, warum das neue Werkzeug nicht immer das richtige ist, wie Sie Performance-Fallen umgehen und wann Sie bewährte Techniken wieder in Ihr Architekturrepertoire aufnehmen sollten. Eine Audio-Vertiefung zu diesem Thema bietet unsere begleitende Podcast-Folge CAML vs REST vs JSON for SharePoint Lists.

Für wen dieser Artikel gedacht ist

Architekten, Administratoren und Maker im Microsoft-Ökosystem stehen vor besonderen Herausforderungen beim Skalieren. Dieser Artikel richtet sich speziell an:

• Power Platform-Maker und SharePoint-Administratoren, die die Performance ihrer Umgebungen optimieren möchten.
• Power Automate-Flow-Entwickler, die mit sporadischen Timeouts und langsamen Ausführungszeiten zu kämpfen haben.
• Enterprise-Architekten, die Listen mit mehr als 5.000 Elementen betreuen oder komplexe, mehrstufige Filter benötigen.
• Entwicklungsteams, die sich aktiv mit 429-Throttling-Fehlern, aufgeblähten Datenmengen oder trägen Benutzeroberflächen auseinandersetzen.

Das Wichtigste in Kürze

• CAML ist nicht tot: Es eignet sich hervorragend für komplexe UND/ODER-Logik, verschachtelte Nachschlagevorgänge, berechnete Felder und große Listen, da die Arbeit an das SharePoint-Backend delegiert wird.
• REST ist überall, aber nicht unbesiegbar: Ideal für Integrationen und Cloud-Tools, aber anfällig für Throttling, aufgeblähte Nutzlasten und clientseitiges Zusammenführen von Daten unter Last.
• JSON-Formatierung = schnelle UI-Erfolge: Perfekt für übersichtliche Ansichten, bis die Elementanzahl steigt und Browser an aufwendiger clientseitiger Logik scheitern.
• Werkzeug passend zur Aufgabe wählen:
  • CAML → umfangreiche serverseitige Filterung, große Datenmengen, präzise Spaltenauswahl
  • REST → Interoperabilität, Connectoren, Integrationen mit Power BI, Teams und Drittanbieter-Lösungen
  • JSON → leichtgewichtige, taktische UI-Verbesserungen (nicht für langfristige Dashboards)

Vertiefung

Warum CAML nicht sterben will

• Stärken
  • Komplexe, tief verschachtelte Filter mit effizienter serverseitiger Ausführung
  • Präzise Spaltenauswahl und Paging; vermeidet, dass Megabyte an Daten übertragen werden
  • Funktioniert gut mit Schwellenwerten für Listenansichten (5.000+), wenn die Abfragen indiziert oder spezifisch sind
• Worauf Sie achten sollten
  • Ausführliches XML; steilere Lernkurve und weniger aktuelle Dokumentation
• Am besten geeignet für
  • Große Listen, komplizierte Geschäftsregeln, berechnete Felder, Filter mit mehreren Nachschlagespalten

REST: Der zweischneidige Standard

• Stärken
  • Universell einsetzbar, gut dokumentiert, connectorfreundlich (Power Automate, Power BI, Teams)
  • Einfache JSON-Nutzlasten; umfassende CRUD-Unterstützung
• Worauf Sie achten sollten
  • Throttling (429er), Wiederholungsversuche und schleichende Verlangsamungen im großen Maßstab
  • Aufwendige clientseitige Datenaufbereitung (Schleifen, Zusammenführen, Filtern) führt zu höherer Latenz
  • Batch-Schreibvorgänge erfordern sorgfältige Orchestrierung und Fehlerbehandlung
• Am besten geeignet für
  • Integrationen, Dashboards, cloudübergreifende Szenarien und schnelle Automatisierungsbausteine

JSON-Formatierung: Individuelle Oberfläche oder unsichtbare Falle?

• Stärken
  • Schnelle, codearme visuelle Aufwertung (Statusanzeigen, Balken, Symbole, Schaltflächen)
  • Ermöglicht Makern, ohne eigene SPFx- oder App-Entwicklung zu arbeiten
• Worauf Sie achten sollten
  • Clientseitige Performance-Kosten steigen mit der Elementanzahl & verschachtelten Bedingungen
  • Wartbarkeit: Komplexe Formatierung wird zu „Klammer-Spaghetti“
  • Plattformänderungen können clevere Lösungen brechen; nutzen Sie es nicht, um Berechtigungen zu „verstecken“
• Am besten geeignet für
  • Kleine bis mittlere Listen, taktische Ansichten, temporäre Dashboards, interne Boards

Entscheidungsrahmen (Kurzcheck)

1. Komplexe Filter oder riesige Listen? Beginnen Sie mit CAML.
2. Benötigen Sie Integrationen oder breite Tool-Unterstützung? Verwenden Sie REST, testen Sie aber die Last, um Drosselung (Throttling) zu erkennen.
3. Brauchen Sie heute noch eine ansprechendere Oberfläche? Setzen Sie JSON sparsam ein; halten Sie die Logik einfach und die Ansichten schlank.
4. Produktionsreife: Indizieren Sie wichtige Spalten, reduzieren Sie die zurückgegebenen Felder und testen Sie mit Daten in Produktionsgröße.
5. Sicherheit: Legen Sie echte Berechtigungen fest. Verbergen Sie Daten nicht mit Formatierungstricks.

Checkliste für Leistung und Ausfallsicherheit

• Indizieren Sie Spalten, die in Filtern und Sortierungen verwendet werden
• Geben Sie nur benötigte Felder zurück (select/expand minimal halten)
• Verwenden Sie CAML für mehrschichtige Logik und präzise serverseitige Filterung
• Implementieren Sie bei REST exponentielles Backoff, Chunking und idempotente Wiederholungsversuche
• Vermeiden Sie clientseitige Schleifen bei großen Nutzlasten; verlagern Sie die Verarbeitung nach Möglichkeit auf den Server
• Halten Sie die JSON-Formatierung minimal; testen Sie mit realistischen Elementanzahlen und älteren Browsern und Geräten
• Überwachen Sie in der Produktion Latenz, 429-Raten, Nutzlastgrößen und fehlgeschlagene Wiederholungsversuche

Typische Fallstricke aus der Praxis

• REST-Migrationen, die Entwicklertests bestehen, brechen bei 40.000–75.000 Elementen ein, aufgrund von Drosselung und Nutzlastgröße
• JSON-lastige Ansichten, die bei 500 Elementen hervorragend aussehen, werden bei 10.000 und mehr deutlich langsam
• Sicherheitsprüfungen, die durch Formatierung offengelegte Metadaten bemängeln, die eigentlich durch Berechtigungen hätten gefiltert werden müssen

Praxisnah: „Wann setzen Sie was ein“

• CAML: Genehmigungsregeln, die berechnete Felder und Nachschlagefelder kombinieren; komplexe UND/ODER-Logik; seitenweises Abrufen, das Schwellenwerte einhält
• REST: Power BI-Anbindungen, Teams-Registerkarten, Konnektoren von Drittanbietern, dienstübergreifende Automatisierungen
• JSON: Statusübersicht für die Geschäftsführung, schnelle farbliche Kennzeichnung, Linkschaltflächen – kurzfristig und mit geringer Komplexität

Fazit

Die richtige Architektur für Ihre SharePoint-Listen und Power Automate-Integrationen bedeutet mehr als nur einen Proof of Concept auf Ihrer lokalen Testwebsite zum Laufen zu bringen. Entscheidend ist zu verstehen, wie sich Ihre Lösungen verhalten, wenn Tausende Datensätze, gleichzeitige Benutzerabfragen und Unternehmensdatenmengen Ihren Code auf die Probe stellen. Ob Sie sich auf die serverseitige Leistung von CAML, die universelle Reichweite von REST-APIs oder die visuelle Wirkung der JSON-Formatierung stützen: Wer die jeweiligen Skalierungsgrenzen kennt, unterscheidet eine fragile Anwendung von einem belastbaren Unternehmenssystem für den Produktivbetrieb. Um diese technischen Abwägungen zu vertiefen und praxisnahe Erfahrungen zu hören, hören Sie unbedingt die begleitende Podcast-Folge: CAML vs REST vs JSON for SharePoint Lists.

Handlungsaufforderung

Haben Sie einen guten CAML-Ausschnitt, eine Geschichte über REST-Drosselung oder einen klugen JSON-Trick? Teilen Sie ihn mit uns. Ihre Lösung könnte den Rollout eines anderen Teams retten.