Voor wie is het partnerportaal bedoeld?
Het partnerportaal is het centrale platform voor alle organisaties, softwareleveranciers of ICT-diensten van scholen die gegevens van scholen willen ophalen of uitwisselen met Informat.
• Op https://partners.informatsoftware.be moeten partners hun applicatie registreren om toegang tot de Informat-API’s te verkrijgen (= client aanvragen).
• Informatbeheerders op school kunnen de partnerapplicaties toegang verlenen tot hun data via het Gebruikersbeheer in Informat (scopes verlenen).
Zowel het aanvragen van de technische sleutels bij Informat als het verlenen van datatoegang door de scholen gebeurt voortaan via dit systeem. Informat valideert de aanvragen van partners en treedt enkel nog op als “moderator”.
Wie heeft welke rol of verantwoordelijkheid?
Informat treedt enkel nog op als moderator om externe partijen toegang te verlenen tot gegevens van scholen in het Informat platform via de API’s. Informat verleent m.a.w. geen toegang tot de data van scholen, dat is de verantwoordelijkheid van de scholen zelf.
1. De partner registreert zich op https://partners.informatsoftware.be
2. De partner registreert de applicatie en doet aanvraag tot API-toegang bij Informat. Na goedkeuring door Informat krijgt de applicatie een “Client ID”. De partner kan een aanvraag sturen naar de Informatbeheerder(s) om toegang te krijgen tot de gegevens van de school.
3. De beheerder kan in het gebruikersbeheer van Informat aan de applicatie toegang verlenen tot de data van de gewenste scholen.
Wat is een client/secret?
Een client/secret combinatie is je persoonlijke toegangssleutel tot één of meerdere API’s van Informat. Een applicatie in het Partnerportaal kan slechts gekoppeld zijn aan max. één client/secret.
Je kan met een client nog geen gegevens van een school uit Informat ophalen, daarvoor moeten er ook toegangsrechten of “scopes” gelinkt zijn aan de client. Toegangsrechten kunnen enkel worden verleend door de schoolbeheerders via het Back-office van het Partnerportaal binnen hun Informat-omgeving.
Heb je meerdere clients ontvangen van Informat voor de verschillende API’s of voor verschillende scholen, dan zal je voor elke client een aparte applicatie moeten registreren.
Wat zijn scopes?
Scopes zijn de toegangsrechten die zijn toegewezen aan een client of applicatie om gegevens van een specifieke school of toegangsgroep met Informat uit te wisselen.
Een scope bepaalt over welke dataset/API het gaat en over welke school/toegangsgroep:
api_informat_<api>.<id van school of toegangsgroep>.
Toegangsrechten op een applicatie worden verleend (én ontnomen) door de Informatbeheerder van een school.