Ga naar hoofdinhoud

Cursad API: Overzicht & Mogelijkheden

De Cursad REST API biedt ontwikkelaars en organisaties volledige toegang tot alle cursusdata en functionaliteit. Met deze krachtige API kun je maatwerkoplossingen bouwen, processen automatiseren en naadloos integreren met bestaande systemen.

Waarom de Cursad API?​

Business Value​

De Cursad API stelt organisaties in staat om:

  • Automatisering: Handmatige taken elimineren en workflows stroomlijnen
  • Integratie: Naadloos koppelen met CRM-systemen, websites, en andere applicaties
  • Maatwerk: Volledige controle over hoe cursusdata wordt gepresenteerd en gebruikt
  • Efficiency: Real-time synchronisatie van data zonder handmatige tussenkomst
  • Schaalbaarheid: Ondersteuning voor groeiende organisaties en gebruikersaantallen

API Mogelijkheden Overzicht​

De Cursad API biedt uitgebreide functionaliteit voor alle aspecten van cursusbeheer:

Cursusbeheer​

Course Offers & Courses

  • Ophalen van alle cursusaanbiedingen (bijv. Accordion, Piano, Gitaar)
  • Gedetailleerde informatie per cursus
  • Filteren op type (groep of individueel), menu's, en meer
  • Course Finder functionaliteit voor geavanceerde zoekopdrachten

Seasons & Planning

  • Beheer van seizoenen en cursusperiodes
  • Ophalen van vakanties per jaar
  • Planning en beschikbaarheid beheren

Inschrijvingen & Subscriptions​

Guest Subscriptions

  • Inschrijven van cursisten via guest accounts
  • Volledige controle over inschrijvingsproces
  • Automatische validatie van inschrijvingsregels

Enrollment Management

  • Controle op beschikbaarheid en capaciteit
  • Validatie van leeftijdsvereisten
  • Beheer van inschrijvingstijden en deadlines

Student & Debiteur Management​

Studenten

  • Ophalen van alle actieve studenten
  • Gedetailleerde studentinformatie per ID
  • Beheer van studentgegevens en profielen

Debiteuren

  • Debiteurbeheer en -informatie
  • Validatie van debiteurvereisten (leeftijd, email)
  • Ondersteuning voor verschillende debiteur-scenario's

Organisatie Structuur​

Divisions & Departments

  • Hiërarchische organisatiestructuur
  • Beheer van divisies en afdelingen
  • Filtering en navigatie door organisatiestructuur

Associations

  • Beheer van verenigingen en partnerschappen
  • Koppeling tussen organisaties en cursussen

Locaties & Docenten​

Locaties

  • Overzicht van alle leslocaties
  • Locaties per cursusaanbod
  • Locatie-specifieke informatie en planning

Docenten

  • Overzicht van alle docenten
  • Docenten per cursusaanbod
  • Docentinformatie en beschikbaarheid

Ondersteunende Functionaliteit​

Age Categories

  • Beheer van leeftijdscategorieën
  • Validatie en filtering op leeftijd

Menus

  • Website menu structuur
  • Hiërarchische menu's en submenu's

Cancel Reasons

  • Redenen voor annulering
  • Tracking en rapportage van annuleringen

Account Management

  • Email status verificatie
  • Account validatie en beheer

Use Cases & Scenario's​

1. Website Integratie​

Integreer het actuele cursusaanbod direct op je website zonder handmatige updates. De API zorgt ervoor dat bezoekers altijd de meest recente informatie zien.

Voordelen:

  • Real-time cursusaanbod op je website
  • Automatische updates bij wijzigingen
  • Volledige controle over presentatie en styling

2. Automatische Inschrijvingen​

Bouw een eigen inschrijfsysteem dat naadloos integreert met Cursad. Ondersteun verschillende betaalmethoden en automatiseer het volledige inschrijvingsproces.

Voordelen:

  • Maatwerk inschrijfformulieren
  • Automatische validatie en verwerking

Best Practices​

Authenticatie​

API Key Beveiliging

  • Bewaar je API key veilig en deel deze nooit publiekelijk
  • Gebruik de key in de Endpoint-Access-Token header: 
    Endpoint-Access-Token: jouw-apikey
  • Rotate keys regelmatig voor extra beveiliging
  • Gebruik verschillende keys voor verschillende omgevingen (development, staging, production)

Key Aanvragen

  • API keys kunnen worden aangevraagd via Cursad
  • Elke key heeft toegang tot alle data van je organisatie

Error Handling​

De Cursad API gebruikt gestructureerde error codes voor betrouwbare foutafhandeling:

Algemene Errors

  • 0x0000 - unknown: Onbekende fout
  • 0x0001 - invalid_request: Ongeldige request
  • 0x0002 - validation_failed: Validatiefout
  • 0x0003 - internal_failure: Serverfout

Authenticatie Errors

  • 0x0101 - unauthorized: Niet ingelogd

Cursus Errors

  • 0x0301 - course_not_found: Cursus niet gevonden
  • 0x0302 - course_full: Cursus vol
  • 0x0305 - course_end_date_passed: Cursus al afgelopen
  • 0x0306 - course_cancelled: Cursus geannuleerd
  • 0x0351 - course_offer_not_found: Cursusaanbod niet gevonden

Inschrijving Errors

  • 0x0401 - already_enrolled: Al ingeschreven
  • 0x0402 - enrollment_closed: Inschrijvingen gesloten
  • 0x0406 - debtor_underaged: Debiteur te jong (minimaal 18 jaar)
  • 0x0407 - debtor_required: Debiteur vereist
  • 0x0408 - debtor_email_address_required: Debiteur email vereist

Paginering​

Endpoints die lijsten retourneren ondersteunen paginering:

  • page: Paginanummer (0-based)
  • size: Aantal items per pagina
  • Response bevat: pageNumber, pageSize, totalCount, totalPages, data

Filtering & Querying​

Veel endpoints ondersteunen filtering:

  • updated_since: Alleen items gewijzigd na deze datum/tijd
  • Specifieke filters per endpoint (zie API documentatie)

Volledige API Documentatie​

Voor gedetailleerde endpoint documentatie, request/response schemas, en voorbeelden, zie de volledige API documentatie.

Hulp & Ondersteuning​

Conclusie​

De Cursad API biedt krachtige mogelijkheden voor organisaties die hun cursusbeheer willen automatiseren en integreren. Of je nu een eenvoudige website integratie bouwt of een complexe enterprise oplossing, de API biedt de flexibiliteit en functionaliteit die je nodig hebt.

Met de juiste implementatie en best practices kun je:

  • Processen automatiseren en tijd besparen
  • Betere gebruikerservaringen bieden
  • Data-driven beslissingen nemen
  • Naadloos integreren met bestaande systemen