Handleiding·Voor beheerders
Openbaar aanbod en online aanmelden
Met het Institution-abonnement publiceer je je opleidingen op je eigen webadres en ontvang je aanmeldingen: via een kant-en-klaar formulier of rechtstreeks vanaf je eigen website.
- 1
Zet je aanmeldinstellingen aan
Open Instellingen → Aanmeldingen. Zet het openbare aanbod aan, bepaal wat er gebeurt als een klas vol zit, kies eventueel hoeveel dagen voor de start de aanmeldingen sluiten, en beslis of docenten aanmeldingen mogen beoordelen.
- 2
Zet opleidingen op openbaar
Open een opleiding → tabblad Instellingen en zet Tonen in openbaar aanbod aan voor elke opleiding die aankomende studenten mogen zien. Houd elk schooljaar open voor aanmeldingen, en vul een startdatum in als je met een sluitingstermijn werkt.
- 3
Je aanbod ophalen op je eigen website
Je ontwikkelaar kan GET /api/catalogue?subdomain=jouw-school aanroepen om je openbare opleidingen en de schooljaren die openstaan op te halen. Jaren die niet actief zijn, jaren die al voorbij zijn en jaren voorbij de sluitingstermijn laten we weg. Zolang je aanbod openbaar staat, is er geen sleutel nodig.
- 4
Maak een aanmeldsleutel aan
Maak bij Instellingen → Aanmeldingen een aanmeldsleutel aan. Je ziet de sleutel maar één keer, dus bewaar hem op je eigen server en nooit in een webpagina.
- 5
Aanmeldingen versturen vanaf je eigen website
POST /api/admissions/applications met Authorization: Bearer ak_… en dezelfde velden als het kant-en-klare aanmeldformulier. Aan de sleutel zien we bij welke instelling het hoort, dus stuur nooit een instellingsverwijzing mee vanuit de browser. Gesloten schooljaren geven VERSION_NOT_OPEN (403) terug.