FAQs: Provider API

In dit artikel vind je:

Wat is de Provider API?
Heb ik de Provider API nodig?
Welke gegevens zijn beschikbaar?
Wat kan ik ermee bouwen?
Wat is niet inbegrepen?
Kunnen gegevens worden toegevoegd of gewijzigd via de Provider API?
Kunnen klanten inloggen via de Provider API?
Wat kost het gebruik van de Provider API?
Waarvoor kan ik de API gebruiken? Welke rate limits gelden er?
Welke technologie gebruikt de Provider API?
Belangrijke begrippen
Hoe ga ik aan de slag?

Wat is de Provider API?

De Provider API is een extensie waarmee je je Eversports Manager-gegevens buiten Eversports kunt gebruiken: op je eigen website, in je eigen app of in de zakelijke tools die je al gebruikt. Je kunt Eversports koppelen aan bestaande software, of er iets nieuws op bouwen.

Zie het als een beveiligd venster op je account. Je developer of bureau gebruikt het om je gegevens op vaste momenten op te halen en ze te tonen waar je ze nodig hebt. Wil een klant boeken of iets kopen, dan wordt hij doorgestuurd naar de Eversports Checkout. Boekingen en betalingen lopen dus nog steeds via Eversports.

Dit artikel is bedoeld voor eigenaren van studio’s, sportscholen en clubs die willen weten wat er mogelijk is voordat ze met een developer gaan praten. Technische kennis is niet nodig.

Heb ik de Provider API nodig?

Misschien niet. Wil je alleen een rooster en boekingsmogelijkheid op je website, dan doen de Eversports-widgets dat zonder developer. De Provider API is de betere keuze als je het volgende wilt:

je eigen design of app, verder dan wat de widgets bieden
Eversports-gegevens combineren met andere tools, zoals een CRM, nieuwsbrief- of rapportagetool
je eigen rapportages over aanwezigheid, leden of baangebruik

Welke gegevens zijn beschikbaar?

De API geeft toegang tot acht onderdelen van je Eversports-account. Elk onderdeel kan worden gefilterd, bijvoorbeeld op locatie, periode, sport of trainer. Alleen de locaties die je voor je integratie inschakelt worden meegenomen.

Onderdeel	Wat je kunt ophalen	Handig voor
Je bedrijf en locaties	Bedrijfsnaam, namen van locaties, adressen, kaartcoördinaten, foto’s en tijdzone	Locatiepagina’s, vestigingszoekers, kaarten
Activiteitenroosters	Lessen, trainingen, cursussen, workshops, kampen, retreats, evenementen en opleidingen, met datum, tijd, zaal, niveau, categoriekleur, beschrijving en afbeeldingen	Roosters en cursuspagina’s op je website
Boekingsgegevens	Of een activiteit boekbaar is, het totaal aantal en het aantal vrije plekken, de boekingsperiode, de annuleringstermijn en een unieke Checkout-link	Beschikbaarheid tonen en mensen doorsturen om te boeken
Trainers	Namen, foto’s, bio en opleiding, plus welke activiteiten ze geven	Teampagina’s en lijsten met “lessen van deze trainer”
Producten	Strippenkaarten, tijdkaarten en memberships, met hun gebruiksregels en een link om ze te kopen	Prijspagina’s
Klanten	Naam, e-mailadres, geboortedatum, profielfoto, archiefstatus en toestemming voor contact	Een CRM of nieuwsbrieftool up-to-date houden
Klantproducten	De kaarten en memberships die elke klant heeft, hoeveel er al gebruikt is, wanneer ze aflopen en eventuele pauzes	Ledenportalen en verlengingsherinneringen
Aanwezigheid en baanboekingen	Wie zich voor welke activiteit of baan heeft aangemeld, of diegene aanwezig was, en late annuleringen	Rapportages over aanwezigheid, no-shows en zaalgebruik

Voor gedetailleerde technische informatie over de beschikbare gegevens kun je het volledige schema bekijken op https://provider-api.eversportsmanager.io/api/graphql

Wat kan ik ermee bouwen?

Op je website

Een rooster in je eigen design. Toon de activiteiten van deze week in jouw kleuren, met filters op sport of niveau en een knop “Nu boeken” bij elke activiteit.
Cursus- en workshoppagina’s. Geef elke cursus een eigen pagina met beschrijving, foto’s, data, trainer en het aantal vrije plekken.
Labels als “Bijna vol”. Laat zien wanneer een activiteit bijna vol of uitverkocht is, op basis van je laatste synchronisatie.
Trainersprofielen. Toon de foto en bio van elke trainer, met de komende activiteiten eronder.
Een prijspagina. Zet je kaarten en memberships op een rij, elk met een link “Nu kopen”.
Een locatiepagina of kaart. Toon al je locaties met adres en kaartmarkering.

Voor je leden

Een ledenomgeving in je eigen app. Laat leden zien hoeveel lessen er nog op hun kaart staan, wanneer hun membership wordt verlengd en welke lessen ze eerder hebben bezocht.
Herinneringen. Stuur een vriendelijk bericht wanneer een kaart bijna op is of een membership bijna afloopt.

Voor je team

Synchronisatie met CRM en nieuwsbrief. Houd klantgegevens up-to-date in je andere tools en mail alleen mensen die toestemming hebben gegeven voor marketing.
Aanwezigheidsrapportages. Houd no-shows en late annuleringen bij, en zie welke activiteiten het snelst vol zitten.
Baan- en zaalgebruik. Zie hoe druk elke baan of zaal is geweest, per dag en tijdstip.
Schermen in je studio. Toon de activiteiten van vandaag op een scherm bij de receptie.

Wat is niet inbegrepen?

Sommige gegevens zijn niet beschikbaar via de API, dus houd daar rekening mee:

Financiële gegevens: facturen, betalingen en omzet
Beschikbaarheid van banen: je kunt gemaakte baanboekingen zien, maar niet welke tijdsloten nog vrij zijn
Andere producten: alleen strippenkaarten, tijdkaarten en memberships zijn inbegrepen, geen vouchers, artikelen of kaarten voor baanboekingen
Privésessies: deze worden niet in roosters opgenomen, tenzij je developer er specifiek naar vraagt

Kunnen gegevens worden toegevoegd of gewijzigd via de Provider API?

Nee. De Provider API is alleen-lezen: je kunt gegevens ophalen uit Eversports Manager, maar niets toevoegen, wijzigen of annuleren. Je regels, prijzen en betalingen blijven op één plek.

Kunnen klanten inloggen via de Provider API?

Niet rechtstreeks. Elke boekbare activiteit heeft een unieke Checkout-link die klanten naar de Eversports Checkout brengt. Een typisch boekingsproces ziet er zo uit:

Je website toont je activiteiten, met gegevens die via de API zijn opgehaald.
Een klant klikt op “Nu boeken” en komt in de Eversports Checkout terecht.
De klant logt in en gebruikt een bestaande kaart of een bestaand membership, of koopt een nieuw.
De boeking wordt opgeslagen in Eversports en verschijnt in de API-gegevens, bijvoorbeeld in aanwezigheidsrapportages.

Wat kost het gebruik van de Provider API?

De prijs begint bij € 50 per maand per locatie. Dit kan variëren afhankelijk van de grootte van je studio en hoe je de API wilt gebruiken. Neem contact op met support@eversports.com voor een offerte.

Waarvoor kan ik de API gebruiken? Welke rate limits gelden er?

De API is bedoeld om je gegevens op vaste momenten naar je eigen systeem te kopiëren. Hij mag niet worden gebruikt als directe backend van je website of app, bijvoorbeeld door het rooster bij elk paginabezoek opnieuw uit de API te laden.

Verder werkt de API op basis van redelijk gebruik (fair use). Er is geen vaste limiet op het aantal aanvragen, maar elke integratie wordt gemonitord en overmatig of schadelijk gebruik kan worden beperkt.

Welke technologie gebruikt de Provider API?

De Eversports Provider API is gebouwd met GraphQL, een querytaal voor API’s.

Met GraphQL-API’s kun je precies aangeven welke gegevens je nodig hebt, alleen die gegevens opvragen en ze ophalen in JSON-formaat.

Je kunt het schema en de functionaliteit van onze API interactief verkennen op https://provider-api.eversportsmanager.io/api/graphql

Belangrijke begrippen

Je developer gebruikt misschien deze termen. Dit is wat ze betekenen.

Term	Betekenis
Company (bedrijf)	Je onderneming als juridische entiteit. Die kan één of meer locaties hebben.
Venue (locatie)	Een van je vestigingen, zoals een studio of sportschool.
Activity (activiteit)	Eén sessie op een vast tijdstip, bijvoorbeeld de yogales van maandag om 7:00 uur.
Activity group (activiteitengroep)	Een reeks activiteiten, zoals een wekelijkse les of een cursus van 6 weken.
Bookable unit (boekbare eenheid)	Wat een klant boekt: een losse les of een hele cursus.
Checkout link (Checkout-link)	De link die een klant naar de Eversports Checkout brengt om te boeken of te kopen.
Product	Een kaart of membership dat je verkoopt.
Customer product (klantproduct)	Een kaart of membership dat een klant heeft.
Participation (deelname)	De aanmelding van een klant voor één activiteit.

Hoe ga ik aan de slag?

Om met de ontwikkeling van je integratie te beginnen, geven we je graag inloggegevens en een Quick Start Guide, zodat je binnen 5 minuten je eerste aanvraag kunt doen.

Neem voor meer informatie contact met ons op via support@eversports.com