Kontodaten mit der Management-API abrufen
- Last verified
- Last verified 18. Okt. 2026
Verwenden Sie „Management v1“, um Kontodaten zu exportieren, ein Data Warehouse oder ein CRM anzubinden, Anwesenheitslisten zu erstellen und Betriebsberichte zu berechnen. Senden Sie GraphQL-Anfragen an /api/graphql/management/v1 unter Verwendung spezieller Kontozugangsdaten. Die API gewährt Lesezugriff auf die Datenkategorien, für die diese Zugangsdaten berechtigen.
Wählen Sie Ihren Arbeitsablauf aus
| Aufgabe | Funktionen von Management v1 |
|---|---|
| Veranstaltungen und Katalog exportieren | Veranstaltungen, Eventvorlagen, Eintritte, Artikel und konfigurierte Preise, Gutscheine, Preiskategorien und -regeln, Standorte, Schlagwörter sowie Vertriebskanäle und Bestellkanäle. |
| Verkäufe und Kundendaten exportieren | Aufträge, Positionen, Preise, Ansprechpartner, Kundenorganisationen und Adressen. |
| Anwesenheitslisten erstellen | Teilnehmerdaten, Informationen zum Check-in, Eintrittskarten sowie deren Zusammenhänge hinsichtlich Bestellung und Preisgestaltung. |
| Finanzen analysieren | Rechnungen und Rechnungspositionen, Zahlungen, Belege und Belegpositionen, Ressourcengebühren sowie gruppierte Umsatzberichte. |
| Ressourcenzuweisungen lesen | Ressourcen, Konfigurationen, Anforderungen, Slots und bestätigte Ressourcen-IDs. |
| Benutzerdefinierte Antworten exportieren | Feldgruppen, Eingaben, Antworten und Werte mit den zugehörigen Datensatz-IDs. |
| Berichte berechnen | Berichte zu Bestellungen, Rechnungen, Kunden, Kontakten, Adressen, Anwesenheiten, benutzerdefinierten Antworten, Veranstaltungen, Ressourcen, Ressourcengebühren sowie zu Umsatzpositionen aus Rechnungen und Belegen. |
Jede Sammlung unterstützt Paginierung, ID-Suche, Änderungszeitstempel und Filter. Detaillierte Datensätze und Berichte nutzen denselben Endpunkt und dieselben Anmeldedaten. Vorhandene Anmeldedaten behalten ihren ursprünglichen Berechtigungsbereich bei; fordern Sie zusätzliche Berechtigungsbereiche an, wenn Sie Datenkategorien hinzufügen.
Management v1 verfügt über keine Schreibvorgänge. Verwenden Sie Booking v1 für die Arbeitsabläufe bei Buchungen für Kunden und beim Bezahlvorgang. Bestehende Alt-Integrationen vom Typ /graphql verwenden eine separate Authentifizierung und ein anderes Schema; deren Vorgänge können nicht unverändert in Management v1 übernommen werden.
Beginnen Sie mit Ihrer Aufgabe
- API-Zugriff erhalten für Ihren API-Host und Ihre Kontozugangsdaten.
- Stellen Sie Ihre erste Anfrage.
- Wählen Sie Daten und Bereiche in der Management-Referenz aus.
- Verknüpfte Datensätze exportieren und Berichte erstellen.
- Jede Seite und spätere Änderungen synchronisieren.
Die generierte Referenz, das GraphQL-Schema und das Manifest beschreiben den ausführbaren Vertrag für die Client-Generierung.
Vollständigkeit des Exports definieren
Wählen Sie die für Ihre Integration erforderlichen Sammlungen und Felder aus und gehen Sie diese nacheinander durch. Die API stellt aktuelle Geschäftsdatensätze bereit, nicht jedoch eine Datenbanksicherung oder alle historischen Versionen. Hochgeladene Dateien, private Download-Links, Geheimdaten von Zahlungsanbietern und Authentifizierungstoken von Kunden werden nicht exportiert. Verworfene Datensätze sind enthalten, sofern die Quelle das Verwerfen unterstützt; dauerhaft gelöschte Datensätze erfordern eine regelmäßige Abstimmung. Lesen Sie bitte den Synchronisationsleitfaden, bevor Sie eine lokale Kopie als vollständig betrachten.
