Hieronder staan een aantal veelgestelde vragen en antwoorden (voor partners).
Kan ik mij registreren als partner?
Elke organisatie, bedrijf of leverancier die in samenwerking met Plantyn/Informat producten of diensten aanbiedt aan scholen kan een profiel aanmaken. De focus ligt op partijen die gegevens uitwisselen met Informat via de API’s.
Registreer een account en voeg daarna een partnerprofiel toe.
Ik heb een profiel toegevoegd, maar ik sta niet in de publieke lijst van partners.
Een partnerprofiel is enkel publiek zichtbaar als er een door Informat goedgekeurde applicatie aan gekoppeld is. Je kan hiervoor een aanvraag doen of jouw bestaande API client koppelen.
Ik wil data uit Informat gebruiken in mijn toepassing
Ben je een softwareleverancier die een oplossing biedt aan scholen op basis van brondata uit Informat, dan moet je je als partner registreren. Je kan één of meerdere apps registreren om toegang te krijgen tot de API’s van Informat. Eén app kan voor meerdere scholen gebruikt worden.
1. Registreer als partner.
2. Registreer een app en vraag een nieuwe client aan.
3. Zodra jouw aanvraag is goedgekeurd door Informat kan een beheerder van de school jouw app toegang geven tot de data van leerlingen, personeel, internen, rekeningen, enz. in Informat.
Ik heb een app geregistreerd, wat nu?
Heb je een app geregistreerd, dan zal Informat de gegevens van de partner en app-registratie nakijken. Dit kan enkele dagen duren. Is de informatie over partner en app volledig en duidelijk, dan volgt de goedkeuring van jouw app. Er wordt een API client toegekend en je ontvangt hiervan een bevestiging via e-mail.
Daarna kan je aan de Informatbeheerder van de school toegang vragen tot schoolgegevens.
Heeft de registratie gevolgen voor mijn huidige API integratie?
De registratie of import van een bestaande client heeft geen technische impact op je integratie. Het is louter een administratieve ingreep om onze gebruikers beter te kunnen ondersteunen.
Mijn app is goedgekeurd, wat nu?
Je hebt nu een API client, maar nog geen scopes die je toegang geven tot de data van een school. Enkel de Informatbeheerder van een school kan aan jouw app de toegang verlenen.
Je kan hiervoor een uitnodiging sturen naar het e-mailadres van de schoolbeheerder(s) van wie je toegang moet krijgen of de schoolbeheerder(s) kunnen jouw app toegang verlenen tot hun data vanuit hun Informat-omgeving (indien de app al scopes heeft voor de instellingsnummers waarvoor ze beheerdersrechten hebben).
Ik heb al toegang tot de Informat API’s
Bestaande clients (uitgeleverd vóór 2026) zijn niet gekoppeld aan een partner of app. Via het Partnerportaal kan je jouw bestaande client eenvoudig koppelen aan een app en behoud je de toegang tot de schoolgegevens. Zo weten we wie de client gebruikt en kunnen we jou nog beter ondersteunen.
1. Registreer als partner.
2. Registreer een app en koppel je bestaande client.
3. Meer hoef je niet te doen. Jouw toegangsrechten blijven behouden en je hoeft ook niks te wijzigen aan de technische implementatie.
De schoolbeheerder kan nu evt. toegang verlenen tot bijkomende gegevens in Informat voor dezelfde school of voor andere scholen.
Ik wil mijn client koppelen, maar die is al gekoppeld aan een andere applicatie.
Een bestaande client/secret combinatie kan je slechts aan één applicatie koppelen en omgekeerd.
Deze situatie kan zich voordoen als een school over één client beschikte, die ze deelden met twee of meerdere partners.
Slechts één partner zal die client kunnen koppelen aan een app.
De andere partners moeten bijgevolg een nieuwe client aanvragen.
Ik gebruik nog de oude SOAP web services (asmx)
De oude webservices zullen we tegen eind 2026 uitfaseren. Plan dit jaar dus de overstap naar de REST API’s van Informat. Vraag dus tijdig je toegang aan tot de REST API’s via het Partnerportaal door je app te registreren.
Ik wil mijn account koppelen met een bestaand partnerprofiel
Indien een collega een partner en app geregistreerd heeft in het Informat Partnerportaal, kan je met jouw eigen account toegang krijgen tot dezelfde gegevens.
1. Vraag je collega om een code te genereren om te koppelen met jullie partnerprofiel.
2. Registreer & activeer een nieuwe account voor jouw e-mailadres.
3. Kies na het aanmelden voor 'Met bestaande partner koppelen'.
4. Geef de code in (de code blijft na aanmaak max. 5 dagen geldig).
Ik wil mijn bestaande client ID/secret registreren
Geen probleem. Je kan je bestaande client importeren en koppelen aan een applicatie.
Zie Handleiding API-Partnerportaal voor partners.
Hoe krijgt mijn app toegang tot de data van een school?
Enkel de schoolbeheerder kan toegang verlenen aan een applicatie om de data van zijn/haar school in Informat op te halen. Dat gebeurt op basis van een uitnodiging die de partner verstuurt naar het e-mailadres van de schoolbeheerder(s). De schoolbeheerder zet per instelling/toegangsgroep de toegang open voor de applicatie in het gebruikersbeheer van Informat.
Noch Informat noch een partner kan beslissen om data van een school te delen met een applicatie. Enkel de Informatbeheerders van een school kunnen datatoegang verlenen (of intrekken).
Mijn applicatie kan geen gegevens meer ophalen voor een school. Wat nu?
Als je applicatie een 403 status code “Forbidden” ontvangt van de API bij het opvragen van gegevens voor een bepaalde scope, controleer dan eerst of de scope nog steeds gelinkt is aan je applicatie/client in het partnerportaal. Heb je m.a.w. nog toegang tot de data van de school in kwestie?
Een schoolbeheerder heeft mogelijk voor jouw applicatie de scope voor het instellingsnummer verwijderd waardoor je de gegevens niet meer mag/kan opvragen. Kijk in de Logs van je applicatie na welke beheerder de toegangsrechten heeft aangepast en neem contact op met die persoon.
Waar vind ik als partner de scopes van mijn applicaties?
Een partnerapplicatie heeft toegang tot de gegevens van één of meerdere scholen. Dit vertaalt zich in één of meerdere “scopes” die aan de client of applicatie zijn gelinkt.
Een partner kan de actieve scopes van een applicatie terugvinden in het partnerportaal. Open de detailpagina van de applicatie en ga naar het tabblad 'API toegang'.
| Om scopes toe te voegen of te verwijderen moet de partner altijd de Informatbeheerder contacteren. Enkel Informatbeheerders kunnen bepalen welke partij of applicatie er wel/geen toegang krijgt tot gegevens van de school. |