U klikte in het startscherm onder "Uw Bouwstenen" op "Toegangsbeheer", vervolgens op "API- en Clientbeheer", en tenslotte op "Mijn OAuth API's". Indien u onthaald wordt op onderstaand scherm, betekent dit dat er momenteel voor uw organisatie geen API's geïntegreerd zijn met het Vlaams Toegangsbeheer (ACM):
Wenst u één of meerdere van uw API's te integreren met het Vlaams Toegangsbeheer (ACM)? Elke entiteit van de Vlaamse Overheid, elk Vlaams lokaal bestuur en elke leverancier die bijdraagt tot de taakstelling van de Vlaamse Overheid, kan zo'n integratie volledig kosteloos afnemen van Digitaal Vlaanderen: er wordt geen aansluitingskost in rekening gebracht noch wordt er een recurrente operationele kost gefactureerd. U mag hiervoor te allen tijde contact opnemen met ons aansluitingsteam via integraties@vlaanderen.be.
Rechtsboven kan u via het pijltje naast de naam van de organisatie namens de welke u momenteel aangemeld bent op het Beheerportaal, desgewenst terugkeren naar het hoedanigheidsselectiescherm (zie boven; sectie "Hoe kan ik me aanmelden op het het Beheerportaal?").
Laat ons er van uit gaan dat er voor uw organisatie wél minstens één API geïntegreerd is met het Vlaams Toegangsbeheer (ACM) - in onderstaand voorbeeld zijn dat er in totaal 5:
Bij elke API staat aangegeven welke de naam van de API is - hierop kan u doorklikken voor meer detail (zie verder) - het type van de API (OAuth API), de status van de API, de datum van de laatste update, en tenslotte een actie-knop "Permissies wijzigen". De functionaliteiten die schuilgaan achter deze actie-knop, worden verderop toegelicht (zie sectie "Permissies wijzigen").
Bij de status van de API wordt, zoals u in bovenstaand voorbeeld kan nagaan, ook aangegeven hoeveel clients er reeds gemachtigd zijn om uw API te consumeren, alsook of en hoeveel clients uw API wensen te consumeren maar hiervoor nog op uw goedkeuring wachten. Zo kan men vaststellen dat er voor de API "Vlaams Mandatensysteem T&I" inderdaad één client is die nog wacht op goedkeuring. De API-eigenaar werd voor een goed begrip ook via mail verwittigd op het moment dat de aanvraag door de beheerder van de client werd ingediend. Dat mailtje gaat steeds uit van het generieke adres beheerportaal-noreply@vlaanderen.be, en zal er als volgt uitzien:
In het bericht zijn de coördinaten van de aanvrager opgenomen - naam en organisatie - alsook de details van de API die in uw beheer is waarop de aanvraag betrekking heeft. Voorts wordt de link meegegeven via de welke u de aanvraag kan goed- of afkeuren. Meer detail kan u desgewenst hieronder terugvinden (zie sectie "OAuth-Clients die wachten op goedkeuring").
Permissies wijzigen
Aan elke API dient een eigenaar te worden toegewezen: deze API-eigenaar staat in voor het beheer van de API in kwestie. Het aanpassen van de eigenaar van een API heeft vanzelfsprekend ingrijpende gevolgen, dus gelieve steeds voorzichtig om te springen met het aanpassen van eigenaarsrechten. Voorts kan een API-eigenaar ook één of meerdere editeerders aan zijn of haar API toewijzen.
Een API-eigenaar kan:
Een API-editeerder kan: