Coachview is een online softwarepakket voor cursusadministratie. Naast het registreren van bijvoorbeeld opleidingen, bedrijven en personen en inschrijvingen in Coachview is het ook mogelijk om data uit Coachview te ontsluiten. Dit doe je met behulp van onze API (Application Programming Interface) en webhooks, een verzameling instructies op basis waarvan applicaties en apparaten onderling kunnen praten.
Tip!
- De releasenotes vind je hier.
- Voorbeelden vind je hier.
Wat zijn webhooks?
| In de wereld van webontwikkeling zijn webhooks essentiële hulpmiddelen voor het realiseren van dynamische en interactieve applicaties. Eenvoudig gezegd, een webhook is een automatische berichtgever. Wanneer een bepaalde gebeurtenis in een systeem plaatsvindt, zoals een update of een nieuw item, stuurt de webhook een melding uit. Meestal in de vorm van een HTTP-verzoek naar een andere applicatie. Dit zorgt voor een directe en efficiënte communicatie tussen verschillende systemen. |
Het belang van webhooks |
| Webhooks zijn bijzonder nuttig. In plaats van constant het systeem te bevragen voor updates, kan een webhook je direct op de hoogte stellen. Dit bespaart tijd en resources en zorgt voor een soepele synchronisatie tussen Coachview en je applicatie. |
Algemeen
Kosten |
| Er zijn geen maandelijkse kosten voor het gebruik van webhooks, maar er zijn wel maandelijkse kosten voor het gebruik van onze API. Meestal worden webhooks gebruik in combinatie met de API. |
Vragen |
| We zijn enthousiast om te zien wat je gaat bouwen met Coachview! Onthoud dat ons team altijd klaar staat om je te ondersteunen bij je ontwikkeltraject. Heb je vragen of loop je ergens tegenaan? Aarzel niet om contact op te nemen. Veel succes en happy coding! |
| Bij vragen kun je contact opnemen met onze supportafdeling, stuur een e-mail naar support@coachview.com. |
Retry mechanisme & foutafhandeling
| Wanneer de webhook verstuurd wordt en deze kan niet afgeleverd worden, dan wordt de webhook nogmaals verstuurd. Wij proberen deze 10x opnieuw te versturen. In totaal sturen wij dus 13x de webhook. Elke keer wordt er langer gewacht tot de volgende keer wordt geprobeerd. | |
|
Bijvoorbeeld Stel dat de webhook vandaag om 11:45 uur verstuurd wordt. Op welke tijdstippen worden deze dan nogmaals gestuurd indien deze niet afgeleverd kunnen worden? | |
Let opGeef de status 200 (succes) z.s.m. terug als de webhook ontvangen is. En niet pas als de webhook helemaal is verwerkt. Coachview wacht niet lang op een antwoord. Bij fouten ook een 200 op de webhook teruggeven, anders wordt de webhook opnieuw geprobeerd totdat deze na 10x als mislukt wordt aangemerkt. Coachview onderneemt dan geen actie. | |
| Webhook | 15-02-2021 11:45 uur |
| 1e keer | 15-02-2021 11:46 uur |
| 2e keer | 15-02-2021 11:48 uur |
| 3e keer | 15-02-2021 11:52 uur |
| 4e keer | 15-02-2021 12:00 uur |
| 5e keer | 15-02-2021 12:16 uur |
| 6e keer | 15-02-2021 12:48 uur |
| 7e keer | 15-02-2021 13:52 uur |
| 8e keer | 15-02-2021 16:00 uur |
| 9e keer | 15-02-2021 20:16 uur |
| 10e keer | 16-02-2021 04:48 uur |
| Is een webhook mislukt? Dan wordt deze standaard 30 minuten op pauze gezet. Dit betekent dat er na een time-out op of het terugkrijgen van een error status code vanuit de payload URL er 30 minuten lang geen retries of nieuwe webhooks worden verstuurd. Als de time-out van 30 minuten is verstreken wordt de webhook die het langste wacht opnieuw geprobeerd. Let op: dit hoeft niet per se de webhook te zijn die voor de time-out heeft gezorgd! | |
Opheffen pauze
| Tijdens het ontwikkelen, testen en inrichten van koppelingen kan dit leiden tot onnodige vertraging, omdat je moet wachten totdat de pauze automatisch verloopt. Wanneer een webhook-abonnement automatisch op pauze wordt gezet na een mislukte webhook, kan deze pauze nu handmatig worden opgeheven. In de waarschuwing is hiervoor de nieuwe actie ‘Abonnement hervatten’ toegevoegd. Na bevestiging wordt de pauze direct verwijderd en neemt het abonnement weer deel aan het reguliere retry-mechanisme. |
September '26