Inhalt
Gutes API-Design für mobile Apps entscheidet darüber, wie schnell Ihre App lädt, wie robust sie bei schlechtem Netz bleibt und wie teuer spätere Erweiterungen werden. REST ist für die meisten Projekte weiterhin die solide Standardwahl, GraphQL spielt seine Stärken bei vielen unterschiedlichen Clients aus, und gRPC lohnt sich vor allem zwischen Diensten. Dieser Artikel zeigt, nach welchen Kriterien Sie entscheiden und welche Regeln unabhängig vom Stil gelten.
Warum mobile APIs anders funktionieren als Web-APIs
Eine Schnittstelle, die im Browser auf dem Büro-PC gut funktioniert, kann auf dem Smartphone enttäuschen. Mobile Clients haben besondere Bedingungen, die das API-Design direkt beeinflussen:
- Wechselnde Netzqualität: Funklöcher, Bahnfahrten und überlastete WLANs führen zu hohen Latenzen und abgebrochenen Requests. Jeder zusätzliche Roundtrip kostet spürbar Zeit.
- Alte App-Versionen im Umlauf: Anders als bei einer Website können Sie nicht erzwingen, dass alle Nutzer sofort aktualisieren. Ihre API muss oft mehrere App-Versionen parallel bedienen – teilweise über Monate.
- Akku und Datenvolumen: Große Payloads und häufiges Polling belasten Akku und Datentarif. Schlanke Antworten sind hier kein Luxus, sondern Nutzererlebnis.
- Review-Zyklen der Stores: Ein Fehler im Client lässt sich nicht in Minuten beheben. Was serverseitig gelöst werden kann, sollte serverseitig gelöst werden.
Daraus folgt eine Grundregel: Entwerfen Sie die API aus Sicht der Bildschirme und Nutzungsabläufe der App, nicht aus Sicht der Datenbanktabellen.
REST, GraphQL, gRPC und BFF im Vergleich
Die folgenden Ansätze schließen sich nicht gegenseitig aus. In vielen Architekturen spricht die App per REST oder GraphQL mit einem Gateway, das intern per gRPC mit Microservices kommuniziert.
| Ansatz | Stärken | Schwächen | Typischer Einsatz |
|---|---|---|---|
| REST (JSON über HTTP) | Einfach, weit verbreitet, HTTP-Caching nutzbar, gute Tooling-Unterstützung (OpenAPI) | Over- und Underfetching, mehrere Requests pro Screen | Die meisten Business-Apps, MVPs, öffentliche APIs |
| GraphQL | Client fragt genau die benötigten Felder ab, ein Endpunkt, stark typisiertes Schema | Caching komplexer, Abfragekosten müssen begrenzt werden, höhere Einstiegshürde | Viele Clients mit unterschiedlichem Datenbedarf, komplexe verknüpfte Daten |
| gRPC / Protocol Buffers | Kompakte Binärformate, Streaming, strikte Verträge | Im Browser nur mit Zusatzschicht, schlechter lesbar beim Debugging | Service-zu-Service-Kommunikation, Echtzeit- und IoT-Szenarien |
| Backend for Frontend (BFF) | Pro Client eine maßgeschneiderte API, Logik bleibt auf dem Server | Zusätzliche Schicht, die gepflegt werden muss | Apps mit eigenständigem Web- und Mobile-Frontend |
| WebSockets / Server-Sent Events | Echtzeit-Updates ohne Polling | Verbindungsmanagement auf Mobilgeräten anspruchsvoll | Chat, Live-Tracking, Kollaboration |
Ergänzend kommen Backend-as-a-Service-Lösungen in Frage, die ihre eigene API mitbringen. Welche Plattform dafür passt, vergleichen wir in Backend für Apps: Firebase, Supabase oder eigener Server.
Entscheidungskriterien: Welcher API-Stil passt zu Ihrer App?
Die Wahl sollte sich an Ihrer Situation orientieren, nicht an Trends. Diese Fragen helfen bei der Entscheidung:
- Wie viele Clients gibt es? Eine App plus Admin-Oberfläche kommt mit REST meist bestens aus. Mehrere Apps, Partner-Integrationen und Web-Frontends mit unterschiedlichem Datenbedarf sprechen eher für GraphQL oder ein BFF.
- Wie verschachtelt sind die Daten? Wenn ein Screen Daten aus fünf Ressourcen kombiniert, spart GraphQL Roundtrips. Bei flachen Strukturen bringt es wenig.
- Wie wichtig ist Caching? REST profitiert direkt von HTTP-Caching, ETags und CDNs. Bei GraphQL müssen Sie Caching auf Client- oder Anwendungsebene gezielter lösen.
- Welche Erfahrung hat das Team? Ein gut gemachtes REST-API ist besser als ein schlecht abgesichertes GraphQL-API.
- Gibt es Echtzeitbedarf? Dann planen Sie zusätzlich WebSockets oder Server-Sent Events ein – unabhängig vom Hauptstil.
In unserer Erfahrung starten die meisten MVPs mit REST und einem sauberen OpenAPI-Vertrag. Ein späterer Wechsel oder eine Ergänzung um GraphQL ist möglich, wenn die API von Anfang an klar strukturiert ist.
Regeln für gutes mobiles API-Design
Unabhängig vom Stil gibt es Prinzipien, die sich in App-Projekten bewährt haben:
- Contract first: Definieren Sie die Schnittstelle zuerst als OpenAPI-Spezifikation oder GraphQL-Schema. So können App- und Backend-Team parallel arbeiten, Mock-Server nutzen und Client-Code generieren.
- Screen-orientierte Endpunkte: Ein Endpunkt wie
/home-feed, der alles für den Startbildschirm liefert, ist für mobile Clients oft besser als zehn generische Einzelabfragen. - Pagination per Cursor: Cursor-basierte Pagination ist bei sich ändernden Listen stabiler als Offset-Pagination und vermeidet doppelte oder fehlende Einträge beim Nachladen.
- Einheitliche Fehlerobjekte: Liefern Sie maschinenlesbare Fehlercodes plus eine verständliche Meldung. Das Format nach RFC 9457 (Problem Details) ist ein guter Standard.
- Idempotenz: Kritische Aktionen wie Bestellungen oder Zahlungen sollten einen Idempotency-Key akzeptieren. Wiederholt die App einen Request nach einem Timeout, entsteht so keine doppelte Buchung.
- Kompression und schlanke Payloads: gzip oder Brotli aktivieren, unnötige Felder weglassen, Bilder in passenden Größen über ein CDN ausliefern.
- Zeitstempel und Änderungsinformationen: Felder wie
updated_atermöglichen inkrementelle Synchronisation – die Basis für Offline-First-Apps mit sauberer Datensynchronisation.
Versionierung: Alte App-Versionen nicht vergessen
Die größte Besonderheit mobiler APIs ist der lange Lebenszyklus alter Clients. Ein unbedachtes Umbenennen eines Feldes kann eine App-Version, die noch auf vielen Geräten läuft, schlagartig unbrauchbar machen. Bewährt haben sich folgende Maßnahmen:
- Nur additive Änderungen: Neue Felder und Endpunkte ergänzen, bestehende nicht umbenennen oder entfernen. Clients müssen unbekannte Felder ignorieren.
- Versionierung bei Breaking Changes: Über den Pfad (
/v2/) oder einen Header. Bei GraphQL werden Felder alsdeprecatedmarkiert und erst nach Ablauf einer Frist entfernt. - Minimale App-Version erzwingen: Ein Endpunkt, der die minimal unterstützte Version liefert, ermöglicht einen kontrollierten Update-Hinweis in der App.
- Nutzung messen: Loggen Sie die App-Version pro Request. So sehen Sie, wann eine alte Version tatsächlich abgeschaltet werden kann.
- Feature-Flags: Neue Funktionen serverseitig aktivieren, statt sie fest im Client zu verdrahten.
Sicherheit und Performance der Schnittstelle
Die API ist die wichtigste Angriffsfläche einer App, denn der Client-Code lässt sich jederzeit analysieren. Geheimnisse wie API-Schlüssel für Drittdienste gehören deshalb nie in die App, sondern auf den Server. Setzen Sie auf etablierte Verfahren wie OAuth 2.0 mit PKCE und kurzlebige Access-Tokens, prüfen Sie Berechtigungen bei jedem Request serverseitig und begrenzen Sie Anfragen per Rate Limiting. Bei GraphQL kommen Abfragetiefe- und Komplexitätslimits hinzu, damit einzelne Queries den Server nicht lahmlegen. Eine ausführliche Übersicht finden Sie in unserem Beitrag zu App-Sicherheit nach OWASP Mobile.
Für die Performance gilt: Messen Sie die Antwortzeiten aus Sicht realer Geräte, nicht nur im Rechenzentrum. Häufig sind es N+1-Abfragen in der Datenbank oder zu große Antworten, die eine App träge wirken lassen. Weitere Hebel beschreibt der Artikel App-Performance optimieren.
Agentic Coding Workshop für Ihr Team? Ab 799 € netto – Preisangebot per E-Mail anfragenFazit
Für die meisten mobilen Apps ist ein sorgfältig entworfenes REST-API mit OpenAPI-Vertrag, Cursor-Pagination, einheitlichen Fehlern und durchdachter Versionierung die beste Wahl. GraphQL lohnt sich bei vielen Clients und stark verknüpften Daten, gRPC vor allem im Backend. Entscheidend ist weniger der Stil als die Disziplin: Schnittstellen aus Nutzersicht entwerfen, alte App-Versionen respektieren und Sicherheit serverseitig durchsetzen. Wenn Sie Ihre App samt Backend planen, erhalten Sie über unseren Angebots-Assistenten nach einer kostenlosen Analyse ein Festpreis-Angebot.
Häufige Fragen
Ist GraphQL besser als REST für mobile Apps?
Nicht grundsätzlich. GraphQL reduziert Roundtrips bei verschachtelten Daten und vielen Clients, REST ist einfacher zu cachen und für die meisten Business-Apps völlig ausreichend.
Wie lange sollte eine alte API-Version unterstützt werden?
Das hängt davon ab, wie schnell Ihre Nutzer aktualisieren. Messen Sie die Verteilung der App-Versionen und schalten Sie eine alte Version erst ab, wenn kaum noch Requests davon kommen und ein Update-Hinweis aktiv war.
Was ist ein Backend for Frontend (BFF)?
Ein BFF ist eine eigene Serverschicht pro Client-Typ, die Daten genau so aufbereitet, wie die jeweilige App oder Web-Oberfläche sie benötigt. Das hält die Clients schlank und die Logik auf dem Server.
Dürfen API-Schlüssel in der App gespeichert werden?
Geheime Schlüssel für Drittdienste gehören nicht in die App, da sich App-Pakete analysieren lassen. Rufen Sie solche Dienste über Ihr eigenes Backend auf und authentifizieren Sie Nutzer mit kurzlebigen Tokens.