Naar hoofdinhoud

KoppelingenCoachview

Coachview API koppelen aan je website.

Coachview is de cursusadministratie van opleidingsinstituten, cursusbureaus en bedrijfsacademies. Wij zetten dat aanbod als eigen pagina’s op je site, met de data en de beschikbare plaatsen erbij, en laten de inschrijving terugkomen in de administratie.

Vertrouwd door

200+ bedrijven en webshops

DuxDux
HappyBedHappyBed
Swim EssentialsSwim Essentials
Washin7Washin7
VouwwagenspecialistVouwwagenspecialist
Fit PrepsFit Preps
Verzijden ClinicsVerzijden Clinics
Fysio MoovFysio Moov
Rund & KipRund & Kip
MörgennMörgenn

Wat het oplevert

Wat een koppeling met Coachview je oplevert.

Je aanbod zonder overtypen. Opleidingen en geplande data komen uit Coachview, dus de site loopt niet achter op de planning.

Een eigen pagina per opleiding. Elke opleiding krijgt een eigen adres op je domein, met je eigen tekst en de eerstvolgende data erbij.

Inschrijven op je eigen site. De inschrijving gaat via de API naar Coachview en staat meteen in de administratie.

Technisch

De koppeling in het kort.

Vorm van de koppeling
REST, met Swagger-documentatie per omgeving
Authenticatie
Een client-id die je aanmaakt in de autorisatie-instellingen, en per aanroep een access token
Richting
Beide kanten op
Verversing
Bij het opvragen; wijzigingen zijn met webhooks door te geven
Wij bouwen het op
WordPress, Next.js, Maatwerk

Waar het misgaat

  • Toegang tot de REST API vraag je aan bij Coachview. Zij zetten hem open via een ticket bij hun supportafdeling, en desgewenst plan je een telefonische afspraak met hun systeemintegrator om de stappen door te nemen. Zonder die stap kun je geen client-id aanmaken en valt er niets te bouwen. Doe het aan het begin van het traject.
  • Een client-id die je op de Swagger-pagina aanmaakt werkt alleen daar. Coachview zegt het er met een uitroepteken bij, en het is precies de val waar je in loopt: je test je aanroep in Swagger, het werkt, en in je eigen code krijg je een 401. Maak voor de koppeling zelf een aparte client-id aan in de autorisatie-instellingen.
  • Er staat geen limiet, er staat een fair use policy. Coachview vraagt dat je gebruik de prestaties voor andere klanten niet beïnvloedt en dat je nadenkt over welke endpoints je echt nodig hebt. Dat is lastiger dan een getal, want je kunt er niet op ontwerpen. Wij halen daarom periodiek op en bewaren aan onze kant, in plaats van bij elke bezoeker aan te kloppen.
  • Er zijn twee omgevingen met elk hun eigen documentatie, en die lopen niet gelijk. Je ontwikkelt op de trainingsomgeving en gaat daarna naar productie. Nieuwe endpoints en wijzigingen verschijnen volgens Coachview eerst in training, dus controleer voor de livegang dat alles wat je gebruikt ook in productie zit.

Bron: documentatie van Coachview, een product van Paragin Group

Wat is Coachview?

Coachview is cursusadministratiesoftware voor opleiders en cursusbureaus, een product van Paragin Group. In het systeem staan de opleidingen, de bedrijven, de personen en de inschrijvingen, en van daaruit lopen de planning en de facturatie.

De gebruikers lopen uiteen: opleidingsinstituten en cursusbureaus, bedrijfsacademies, hogescholen en universiteiten, en opleiders in vervoer en logistiek, ICT, bouw, arbo en veiligheid, zorg en de financiële en juridische hoek. Het pakket bestaat uit de modules Essentieel, Efficiënt en Inzicht, met daarnaast een docentapp, een cursistapp en een opleidingsportaal.

Voor een website gaat het om twee dingen: welke opleidingen er zijn en wanneer ze draaien, en hoe iemand zich inschrijft. De rest van de administratie blijft waar hij hoort.

Hoe de koppeling met je website werkt

Via de REST-API van Coachview. Die kan volgens hun eigen omschrijving twee dingen: data uit Coachview ontsluiten en data in Coachview plaatsen, en dat tweede noemen ze zelf met het voorbeeld van een inschrijving via de website.

Je maakt een client-id aan in de autorisatie-instellingen en haalt daarmee een access token op. Dat token gaat mee bij elke aanroep; zonder geldig token krijg je een 401 en komt er niets binnen of uit. De levensduur van het token stel je in op vijftien minuten, een uur of acht uur, en Coachview adviseert hem zo kort mogelijk te houden.

Wij halen het aanbod op, bewaren het aan onze kant en maken er eigen pagina’s van met zoeken en filteren. Het inschrijfformulier staat op je eigen site en schrijft via de API weg. Met webhooks kan Coachview een seintje geven wanneer er iets verandert, zodat de site niet hoeft te blijven vragen.

Twee omgevingen, en waarom dat prettig is

Coachview biedt de API op twee plekken aan: een trainingsomgeving en een productieomgeving, allebei op een eigen adres met de klantnaam erin. De trainingsomgeving noemen ze zelf de speeltuin: wat je daar doet raakt de live gegevens niet.

Dat is meer waard dan het klinkt. Bij een inschrijfkoppeling schrijf je echte gegevens weg, en een test die per ongeluk in de productieadministratie belandt is niet met één knop terug te draaien. Wij bouwen en testen daarom eerst op training en zetten daarna pas om.

Eén ding om op te letten: de twee omgevingen lopen niet gelijk. Er is per omgeving aparte documentatie, want nieuwe endpoints komen eerst in training. Voordat er iets live gaat controleren we dus of alles wat we gebruiken ook aan de andere kant bestaat.

Eigen pagina’s of het opleidingsportaal

Coachview heeft een eigen opleidingsportaal met een standaardpagina voor je aanbod. Dat werkt en het staat er snel.

Het verschil zit in waar je aanbod terechtkomt. Een portaal draait op een adres van de leverancier of op een subdomein, en wat daar staat telt niet mee voor je eigen site. Iemand die zoekt op een cursusnaam met een plaats erachter komt daar niet uit bij jouw pagina, want die is er niet.

Met een koppeling bouwen we per opleiding een echte pagina van je site: eigen adres, eigen tekst, de eerstvolgende data erbij en de inschrijfknop erop. Dat is ook de plek waar je uitlegt waarom jouw cursus anders is, en dat is precies wat een standaardportaal niet doet. Coachview blijft de administratie; de site wordt de etalage.

Bijgewerkt op

Specialist voor koppelingen

Jos van der PluijmJosDesign & Development085 83 30 533jos@klubb.nl

Veelgestelde vragen

Kan ik mijn cursusaanbod uit Coachview op mijn eigen website tonen?

Ja. De REST-API van Coachview kan data ontsluiten, dus we halen de opleidingen en de geplande data op en maken er eigen pagina’s van op je eigen domein. Coachview blijft de plek waar je de planning beheert; de site toont wat daar staat.

Heeft Coachview een API?

Ja, een REST-API met Swagger-documentatie. Die kan twee kanten op: gegevens uit Coachview halen en gegevens erin plaatsen, bijvoorbeeld een inschrijving die via je website binnenkomt. Toegang vraag je aan bij hun support.

Kan iemand zich via mijn eigen site inschrijven?

Ja, dat noemt Coachview zelf als voorbeeld van data in Coachview plaatsen. Het formulier staat op jouw site, in jouw vormgeving, en de inschrijving komt via de API in de administratie terecht zonder dat iemand iets overtypt.

Hoe krijg ik toegang tot de API?

Via een ticket bij de supportafdeling van Coachview; zij zetten de REST-API open. Desgewenst plannen ze een telefonische afspraak met hun systeemintegrator om de stappen door te nemen. Regel dat aan het begin, want zonder toegang kun je geen client-id aanmaken.

Waarom werkt mijn client-id uit Swagger niet in mijn eigen code?

Omdat die daar niet voor is. Coachview zegt het er expliciet bij: een client-id die je via de Swagger-pagina aanmaakt kun je niet buiten die pagina gebruiken. Maak voor de koppeling een aparte client-id aan in de autorisatie-instellingen van de juiste omgeving.

Werkt een Coachview-koppeling ook op WordPress?

Ja. We slaan het opgehaalde aanbod op als eigen berichttype in WordPress, zodat zoeken, filteren en losse opleidingspagina’s werken zoals de rest van je site. Het inschrijfformulier schrijft vanaf de server weg, zodat de sleutels niet in de paginabron staan.

Let’s work together.

Je cursusaanbod op je eigen site, je inschrijvingen in Coachview.