Coachview is een online softwarepakket voor cursusadministratie. Naast het registreren van opleidingen en inschrijvingen in Coachview is het ook mogelijk om gegevens uit Coachview te koppelen met jouw eigen website. Dit geldt ook voor websites met CMS, waaronder Wordpress, Joomla, Drupal, enz. Coachview biedt twee vormen van webservice-communicatie / abonnementen aan. Publicatie en webaanvraag. Deze twee vormen kunnen afzonderlijk of gezamenlijk afgenomen worden.
 |
Let op: webservices worden niet meer ondersteund, er zullen geen updates meer plaatsvinden. Koppel via onze API's! Lees hier meer over het gebruik van onze REST API's. |
Mogelijkheden
Met behulp van webservices worden deze gegevens doorgegeven van Coachview naar de website en andersom.
- Met behulp van publicatie kunnen opleidingsgegevens uit Coachview getoond worden op de website. Denk hierbij aan een overzicht van alle beschikbare opleidingen of een cursusagenda.
- Met behulp van webaanvraag kunnen deelnemersgegevens doorgegeven worden vanuit de website naar Coachview Denk hierbij aan een online inschrijfformulier.
Fair use policy
De webservices worden aangeboden op basis van een 'fair use policy'. Dat betekent dat jouw gebruik van de webservices de prestaties voor andere klanten niet mag beïnvloeden. Het maximaal aantal requests staat daarom standaard ingesteld op 5000 per dag (ook weekenden). Dit maximum geldt voor de productietijden, van 08:00 uur tot 20:00. Buiten deze tijden geldt een maximum van 50.000 requests. Het totaal aantal requests op één dag is 50.000 request. Heb je in de ochtend voor 08:00 uur al 50.000 requests gedaan dan heb je geen requests meer over voor de rest van deze dag. Op het moment dat wij constateren dat er teveel requests worden ingediend, word je uiteraard op de hoogte gesteld zodat je aanpassingen kan doen. Het is bijvoorbeeld niet toegestaan om complete datasynchronisaties vaker dan eens per dag uit voeren. Deze mogen alleen 's nachts plaatsvinden. Wil je hier van afwijken, neem dan contact op met de helpdesk om de mogelijkheden te bespreken.
Coachview omgevingen
Er zijn twee omgevingen beschikbaar om jouw webservice te koppelen:
- In de trainingsomgeving kun je jouw webservice ontwikkelen. Tests die je hier uitvoert hebben geen invloed op de live data. Let op: de trainingsomgeving wordt elke maand overschreven met gegevens uit de live-omgeving.
- De live-omgeving gebruik je om actuele gegevens op te halen of weg te schrijven.Nadat succesvol de webservice koppelingen in de trainingsomgeving getest zijn, ontvang je van de helpdesk de authenticatiesleutels om de koppeling te maken met de live-omgeving.
In overleg is het mogelijk een beperkte, tijdelijke, inlog te verkrijgen in onze trainingsomgeving.
Webservices aanroepen
- Coachview ondersteunt enkel het aansturen van één request tegelijk. Nadat Coachview een response heeft gestuurd, kan de volgende request worden verricht. In de praktijk zul je hier vrijwel geen vertraging van ondervinden.
- Het 'async' aanroepen van de webservices, dat wil zeggen dat meerdere requests direct na elkaar worden gestuurd zonder te wachten op antwoord/resultaat van Coachview wordt niet ondersteund. Het kan dus gebeuren dat een of meerdere requests niet goed verwerkt worden.
Aan de slag!
Alvorens je aan de slag kunt, hebben we het ip adres van de webserver nodig. Zodra we deze ontvangen hebben, zullen we een security key uitgeven. Elke omgeving heeft zijn eigen security key. Deze security key werkt alleen in combinatie met het IPadres van de server waarop de website draait. Elke keer als er een webservice wordt aangeroepen wordt, zal deze security key dus meegestuurd moeten worden.Geef het ip adres van de webserver door aan jouw contactpersoon binnen Coachview of aan onze supportafdeling.
Via deze URL vind je alle webservices die beschikbaar zijn.:
Als de website verhuisd wordt of er wordt gebruik gemaakt van een ander IP-adres dan moet deze wijziging van het IP-adres doorgegeven worden aan de supportafdeling van Coachview. Onze supportafdeling zal dan een nieuwe security key leveren waarmee vanuit het gewijzigde IP-adres verbinding gemaakt kan worden met Coachview.
Vragen?
 |
Bij vragen kun je contact opnemen met onze supportafdeling, stuur een e-mail naar support@coachview.com. |
 |
Houdt er rekening mee dat webservices niet altijd beschikbaar zijn. Daarom adviseren we om altijd een check in de website in te bouwen waarin gecontroleerd wordt of Coachview beschikbaar is voor verwerking van webaanvragen. Je kunt deze inschrijving 'parkeren' of op de website aangeven dan inschrijven tijdelijk niet mogelijk is. Hiermee voorkom je een inschrijving die verstuurd wordt, maar niet aankomt. |