Hieronder staan een aantal veelgestelde vragen omtrent het partnerportaal (voor schoolbeheerders).
Ik ben een school en wil de Informat API’s gebruiken.
Wil je als school zelf aan de slag met de API’s van Informat om gegevens op te halen voor een interne toepassing, dan moet je je ook eerst registreren als partner.
1. Registreer als partner (kies “Privé” indien je niet wil dat je school in de lijst van partners verschijnt).
2. Registreer een app en vraag een API client aan.
3. Zodra je aanvraag is goedgekeurd door Informat, kan een Informat-beheerder via Gebruikersbeheer 2.0 de app toegang geven tot de data van leerlingen, personeel, internen, rekeningen, enz. Je kan hiervoor een bericht naar het e-mailadres van de beheerder sturen.
Wat gebeurt er als ik een scope toevoeg voor een applicatie?
Als een schoolbeheerder een instelling van links naar rechts verplaatst voor een API, dan wordt er achterliggend aan de client een scope gelinkt voor de betrokken API en de school. Dat wil zeggen dat de client vanaf dan toegang heeft tot de resp. gegevens in Informat, bv. de leerlingendata van school X of de personeelsdata van school Y.
Deze actie heeft geen impact op de technische integratie van de toepassing van de partner, het is louter de toestemming van de school dat de applicatie van de partner de betrokken gegevens kan uitlezen.
De partner (en applicatie) zal via e-mail een bericht ontvangen als er scopes zijn gewijzigd voor zijn applicatie. De partner moet de nieuwe scopes daarna zelf toevoegen in zijn omgeving zodat de partnertoepassing de gegevens van de school ook effectief uitwisselt met Informat.
Ik ben beheerder, maar kan geen toegangsrechten verlenen aan een applicatie
Heb je een uitnodiging ontvangen van de partner in je mailbox, maar lukt het niet om rechten toe te kennen aan de app? Meld aan bij Informat en klik daarna op de link in de e-mail om de applicatiepagina te openen.
Je ziet voor elke API die de applicatie gebruikt een “switch list” als je beheerdersrechten hebt voor de overeenkomstige applicatie(s) in Informat:
• Leerlingen API: beheerder voor iBasis of iLeerlingen
• Personeel API: beheerder iPersoneel
• Internen API: beheerder iInternen
• Rekeningen API: beheerder Rekeningenmodule
Zie ook Handleiding Partnerportaal voor schoolbeheerders.
Hoe geef ik een nieuwe app toegang tot mijn data als Informatbeheerder?
De partner moet je een toegangsverzoek sturen per e-mail.
De e-mail die gegenereerd wordt heeft als onderwerp 'Informat Partnerportaal - Datatoegang voor applicatie “<Naam app>”' en bevat een unieke hyperlink waarmee je de applicatie toegangsrechten kan verlenen.
1. Meld aan bij Informat.
2. Klik op de link in de e-mail om de applicatiepagina te openen.
3. Open het tabblad “API toegang”.
4. Geef nu toegangsrechten per API aan de instellingen/toegangsgroepen door ze links te selecteren en naar rechts te verplaatsen.
5. Bewaar je wijzigingen. De partner en app ontvangen een e-mail dat er scopes zijn gewijzigd.
Hoe kan ik bijkomende toegangsrechten verlenen aan een app als Informatbeheerder?
Als een applicatie reeds scopes of toegangsrechten heeft voor instellingen of toegangsgroepen waar jij beheerder van bent, dan kan je als beheerder, zonder uitnodiging van de partner, extra toegangsrechten toekennen in het Back-office van het Partnerportaal.
1. Open 'Gebruikersbeheer 2.0' (zie je enkel als je beheerder bent).
2. Ga naar 'API Portaal'.
3. Open Apps.
4. Open de app en daarna het tabblad 'API toegang'.
5. Geef nu toegangsrechten per API aan de instellingsnummers/toegangsgroepen door ze links te selecteren en naar rechts te verplaatsen.
6. Bewaar je wijzigingen. De partner en app ontvangen een e-mail dat er scopes zijn gewijzigd.