GraphQL API
Die primäre API für jede Flowtig-Anwendung.
GraphQL ist die primäre Schnittstelle für die Entwicklung von Anwendungen auf der Flowtig-Plattform.
Alle Geschäftsanwendungen – darunter Kontakte, Arbeitszeit, Zeiterfassung, Rechnungen und Lager – kommunizieren über GraphQL. Die API bietet stark typisierten Zugriff auf mandantenspezifische Geschäftsdaten und berücksichtigt dabei automatisch Berechtigungen und Organisationsgrenzen.
Anwendungs-API
Wenn Sie eine Flowtig-Anwendung entwickeln, ist GraphQL Ihre primäre API.
Geschäftslogik gehört in GraphQL.
Warum GraphQL?
Flowtig verwendet GraphQL, weil unterschiedliche Anwendungen unterschiedliche Daten benötigen und gleichzeitig dieselbe Plattform verwenden.
GraphQL ermöglicht jedem Client, genau die benötigten Daten abzufragen, ohne unnötige Netzwerkanfragen oder mehrfach vorhandene Endpunkte.
Typische Vorteile sind:
- Starke Typisierung
- Präzise Auswahl benötigter Felder
- Vorhersehbare Schemas
- Selbstdokumentierende APIs
- Effizienter Datenabruf
Was kann ich entwickeln?
Alle Flowtig-Anwendungen kommunizieren über GraphQL.
Beispiele sind:
- Kontakte
- Arbeitszeit
- Zeiterfassung
- Rechnungen
- Rechnungsarchiv
- Lager
- Bautagebuch
- Immobilien
- und viele weitere.
Jede Anwendung verwaltet ihren eigenen fachlichen Bereich und verwendet gleichzeitig dasselbe Authentifizierungs- und Berechtigungsmodell.
Mandantentrennung
Jede GraphQL-Anfrage wird im Kontext einer einzelnen Organisation ausgeführt.
Die Plattform stellt automatisch Folgendes sicher:
- Mandantentrennung
- Prüfung der Organisationszugehörigkeit
- Anwendungsberechtigungen
- Berechtigungen auf Objektebene
Anwendungen müssen weder manuell zwischen Datenbanken wechseln noch Daten selbst nach Organisation filtern.
In die Plattform integriert
Mandantenfähigkeit ist Bestandteil der Plattformarchitektur und muss nicht von jeder Anwendung selbst implementiert werden.
Weitere Informationen finden Sie in der Dokumentation zur Architektur.
Queries & Mutations
GraphQL stellt zwei grundlegende Operationstypen bereit.
Queries
Verwenden Sie Queries, wenn Sie Informationen abrufen möchten.
Typische Beispiele sind:
- Kontakte abrufen
- Rechnungen laden
- Projekte laden
- Lagerbestände durchsuchen
Mutations
Verwenden Sie Mutations, wenn Daten erstellt, geändert oder gelöscht werden sollen.
Typische Beispiele sind:
- Eine Rechnung erstellen
- Einen Kontakt aktualisieren
- Einen Lagergegenstand löschen
- Eine Aufgabe abschließen
Schema-Design
Jede Flowtig-Anwendung besitzt ihr eigenes GraphQL-Schema.
Dadurch bleiben fachliche Bereiche klar voneinander getrennt und Anwendungen können unabhängig voneinander weiterentwickelt werden.
Die Plattform setzt dabei auf:
- Klare Verantwortlichkeiten für Schemas
- Einheitliche Benennung
- Starke Typisierung
- Stabile Schnittstellen
Interaktive Dokumentation
Das vollständige GraphQL-Schema steht über den interaktiven GraphQL-Explorer zur Verfügung.
Dort können Sie:
- Alle Typen durchsuchen
- Verfügbare Queries entdecken
- Mutations erkunden
- Beziehungen zwischen Typen untersuchen
- Testabfragen ausführen
👉 https://api.flowtig.com/graphql/docs
Weiterführende Dokumentation
Folgende Dokumentationen könnten ebenfalls interessant sein:
Benötigen Sie Hilfe?
Haben Sie Fragen zur GraphQL API?
Besuchen Sie die interaktive API-Dokumentation oder kontaktieren Sie uns unter:
👉 https://flowtig.com/contact