FAQs: Anbieter-API
Eine Erweiterung für Anbieter:innen zur automatisierten Abfrage des Stundenplans über eine Programmierschnittstelle (API)
In diesem Artikel findest du:
↪︎ Was ist die Provider-API?
↪︎ Brauche ich die Provider-API?
↪︎ Welche Daten sind über die Provider-API abrufbar?
↪︎ Was kann ich damit bauen?
↪︎ Was ist nicht inkludiert?
↪︎ Können über die Provider-API auch Daten erstellt oder geändert werden?
↪︎ Können sich Kund:innen über die Anbieter-API direkt anmelden?
↪︎ Was kostet die Nutzung der Anbieter-API?
↪︎ Wofür kann ich die API verwenden? Gibt es Nutzungslimits?
↪︎ Welche Technologie wird verwendet?
↪︎ Wichtige Begriffe
↪︎ Wie starte ich mit der Integration?
Was ist die Provider-API?
Die Provider-API ist eine Erweiterung die dich deine Eversports Manager Daten außerhalb von Eversports verwenden lässt: auf deiner Website, deiner eigenen App, oder deinen Unternehmenstools die du bereits verwendest. Du kannst Eversports mit einer bestehenden Software verbinden, oder etwas neues bauen.
Stelle es dir als sicheres Zugangsfenster zu deinem Eversports Manager Konto vor. Deine Entwickler:in oder Agentur kann es nutzen, um in regelmäßigen Intervallen deine Daten abzurufen und sie dort anzuzeigen, wo du sie benötigst.
Dieser Artikel richtet sich an Betreiber:innen von Boutique Studios, Fitnessstudios und Vereinen die wissen möchten, was möglich ist bevor sie mit einer Entwickler:in sprechen.
Technische Kenntnisse sind nicht erforderlich.
Brauche ich die Provider-API?
Vielleicht nicht. Wenn du nur deinen Stundenplan und Buchung auf deiner Website ermöglich willst, dann kannst du das über die Eversports Widgets* machen - dafür brauchst du keine Entwickler:in.
Die Provider-API ist die bessere Wahl wenn du:
- dein eigenes Design oder App willst, die über die Funktionen der Widget hinausgehen
- Eversports-Daten mit anderen Tools verknüpfen willst, wie beispielsweise einem CRM, einem Newsletter-Tool oder einem Berichtstool
- eigenen Berichte über Besucherzahlen, Mitglieder oder die Nutzung der Räumlichkeiten erstellen willst
*Lies mehr über den Einsatz der Eversports Widgets hier.
Welche Daten sind über die Provider-API abrufbar?
Die API gibt dir Zugang zu acht Bereichen deines Eversports Manager Account. Jeder Bereich kann gefiltert werden, z.B. nach nach Studio, Zeitraum, Sportart oder Trainer:in. Es werden nur die Studios inkludiert, die du für die Integration aktiviert hast.
| Bereich | Was du bekommst | Wofür es nützlich ist |
| dein Unternehmen und Studios | Unternehmensname, Studionamen, Adressen, Koordinaten, Fotos und Zeitzone | Standort Seiten, Store Finder, Karten |
| Stundenpläne für Aktivitäten | Klassen, Trainings, Kurse, Workshops, Camps, Retreats, Events und Ausbildungen, mit Datum, Zeiten, Raum, Level, Farbe der Aktivitätsgruppe, Beschreibung und Bilder | Stundenpläne und Kursseiten auf deiner Website |
| Buchungsdetails | Ob eine Aktivitäten gebucht werden kann, Gesamtzahl und freie Plätze, Buchungszeitraum, Stornierungsfrist und ein individueller Checkout-Link | Anzeige der Verfügbarkeiten und um Kund:innen zum Buchen zu leiten |
| Trainer:innen | Namen, Fotos, Beschreibung (Bio) und Ausbildung, zudem welche Aktivitäten sie unterrichten | Team-Seiten und Listen die "Klassen mit Lehrer:innen" zeigen |
| Produkte | Blockkarten, Zeitkarten und Memberships, mit deren Nutzungsregeln und einem Link um diese zu kaufen | Preis-Seiten |
| Kund:innen | Name, E-Mailadresse, Geburtsdatum, Profilbild, Archiv-Status und Kommunikationspräferenz | Synchronisation eines CRM oder Newsletter-Tools |
| Produkte von Kund:innen | Die gekauften Karten und Memberships jede:r Kund:in, wie viele diese verwendet wurde, wann diese Auslaufen (Gültigkeit) und jegliche Pausierungen | Portale für Mitglieder und Reminder zur Erneuerung |
| Teilnahme und Platzbuchungen | Wer sich für welche Aktivitäten oder Platz angemeldet hat, ob sie anwesend waren oder eine Spätabsage getätigt haben | Berichte zu Anwesenheit, No-Shows und Raumnutzung |
Für detaillierte technische Information zu den verfügbaren Daten kannst du dir hier das vollständige Schema ansehen: https://provider-api.eversportsmanager.io/api/graphql
Was kann ich damit bauen?
Auf deiner Website:
- Einen Stundenplan in deinem eigenen Design. Zeige die wöchentlichen Aktivitäten in deinen Farben, Filtern nach Sport oder Level, und einem "Jetzt buchen"-Button auf jeder Aktivität.
- Kurs und Workshop Seiten. Gib jedem Kurs und Workshop seine eigene Seite mit Beschreibung, Bild, Terminen, Trainer:innen und freien Plätzen.
- "Fast ausgebucht"-Labels. Zeige, dass eine Aktivität fast voll oder ausgebucht ist, basierend auf deiner letzten Synchronisation.
- Trainer:innen Profile. Zeige die Profilbilder und Beschreibungen deiner Trainer:innen mit ihren zukünftigen Aktivitäten.
- Seite zur Preisübersicht. Zeige deiner Karten und Memberships, jeweils mit einem "Jetzt kaufen"-Link.
- Standort-Seite oder Karte. Zeige alle deine Studios mit Adressen und Markierung auf der Karte.
Für deine Mitglieder:
- Mitgliederbereich in deiner eigenen App. Lass deine Mitglieder einsehen wie viele Einheiten sie auf ihrer Karte übrig haben, wann sich ihre Membership erneuert, und welche Aktivitäten sie in der Vergangenheit gebucht haben.
- Erinnerungen. Versende freundliche Erinnerungen wenn eine Karte verbraucht wurde oder eine Membership kurz vor dem Ablaufen ist.
Für dein Team:
- CRM und Newsletter Synchronisation. Halte deine Kund:innen-Daten aktuell in anderen Tools, und versende E-Mails nur an Kund:innen die der Marketingkommunikation zustimmen.
- Anwesenheitsberichte. Verfolge No-Shows, Spätabsagen und welche Aktivitäten am meisten gebucht werden.
- Platz- und Raumnutzung. Behalte im Blick welche Plätze und Räume verwendet wurden, nach Tag und Uhrzeit.
- Bildschirme in deinem Studio. Zeige die Aktivitäten des heutigen Tages an deiner Rezeption.
Was ist nicht inkludiert?
Manche Daten sind nicht verfügbar über die API:
- Finanzielle Daten: Rechnungen, Zahlungen und Umsatz
- Platzverfügbarkeit: Du kannst sehen welche Platzbuchungen getätigt wurden, aber nicht welche Zeitfenster noch verfügbar sind
- Andere Produkte: Nur Blockkarten, Zeitkarten und Memberships sind inkludiert, nicht Gutscheine, Artikel oder Karten für Platzbuchungen.
- Privatstunden: Privatstunden sind nicht in den Stundenplänen inkludiert, außer deine Entwickler:in sucht gezielt danach
Können über die Provider-API auch Daten erstellt oder geändert werden?
Nein. Die Provider-API ist read-only – es können nur bestehende Daten aus dem Eversports Manager abgerufen, aber nicht verändert oder ergänzt werden. Deine Regeln, Preise und Zahlungen bleiben an einem Ort.
Können sich Kund:innen über die Anbieter-API direkt anmelden?
Nicht direkt. Für jede buchbare Aktivität wird ein individueller Checkout-Link generiert, welcher Kund:innen zum Eversports Check-Out leitet. Ein reguläre Buchung läuft folgendermaßen ab:
-
Deine Website zeigt deine Aktivitäten, basierend auf den Daten die über die API eingeholt werden.
- Eine Kund:in klickt auf "Jetzt buchen" und landet im Eversports Check-Out.
- Die Kund:in loggt sich ein, und verwendet dann eine bestehende Karte oder Membership oder kauft eine neue.
- Die Buchung wird in Eversports gespeichert, und wird in den API-Daten angezeigt (z.B. in den Anwesenheitsberichten).
Was kostet die Nutzung der Anbieter-API?
Die Preise starten bei 50 € pro Monat und pro Standort, können aber je nach Unternehmensgröße und deinem Anwendungszweck für die API variieren.
Kontaktiere uns unter support@eversports.com, um mehr zu erfahren.
Wofür kann ich die API verwenden? Gibt es Nutzungslimits?
Die Anbieter-API dient dazu, Aktivitätsdaten regelmäßig abzurufen und mit deinem System zu synchronisieren. Die API darf nicht als direktes Backend deiner Website oder App verwendet werden, beispielsweise indem der Stundenplan jedes Mal über die API geladen wird, wenn jemand deine Seite besucht.
Die Nutzung erfolgt auf Fair-Use-Basis. Es gibt kein festes Limit für Anfragen, aber jede Integration wird überwacht, und eine übermäßige oder schädliche Nutzung kann eingeschränkt werden.
Welche Technologie wird verwendet?
Die Anbieter-API basiert auf GraphQL, einer modernen Abfragesprache für APIs.
Mit GraphQL kannst du exakt die Daten abrufen, die du benötigst – das Ergebnis erfolgt im JSON-Format.
Du kannst das API-Schema hier interaktiv testen: https://provider-api.eversportsmanager.io/api/graphql
Wichtige Begriffe
Deine Entwickler:in verwendet wahrscheinliche die folgenden Begriffe - das bedeuten sie:
| Begriff | Bedeutung |
| Unternehmen (Company) |
Dein Unternehmen als legale Es kann einen oder mehrere Standorte haben. |
| Studio (Venue) |
Einer deiner Standorte für Studio oder Fitnessstudio |
| Aktivität | Eine einzelner Termin zu einer bestimmten Zeit, z.B. Yoga-Klasse am Montag um 07:00 |
| Aktivitätengruppe (Activity group) |
Eine Reihe von Aktivitäten, wie eine wöchentliche Klasse oder 6-Wochen Kurs |
| Buchbare Einheit (Bookable Unit) |
Was eine Kund:in bucht: eine einzelne Klasse oder gesamten Kurs |
| Check-Out Link | Der Link der Kund:innen zu der Eversports Check-Out Seite zum Buchen oder Kaufen bringt |
| Produkt | Eine Karte oder Membership die du verkaufst |
| Kund:innen-Produkt (Customer product) | Eine Karte oder Membership die eine Kund:in besitzt |
|
Teilnahme |
Die Anmeldung (Sign-Up) einer Kund:in für eine Aktivität |
Wie starte ich mit der Integration?
Unser Team stellt dir gerne Zugangsdaten und einen Quick Start Guide zur Verfügung – für deine erste API-Abfrage in weniger als 5 Minuten.
Bei Interesse schreibe uns an support@eversports.com