Het MAGDA-platform stelt tal van webservices voor punctuele bevraging ter beschikking. Deze en onderliggende pagina’s schetsen het algemene kader van deze MAGDA webservices, het proces, foutafhandeling, opbouw verzoek/repliek, ... . Voor een overzicht van alle beschikbare MAGDA-diensten wordt verwezen naar Handleidingen dienstenaanbod. |
Het MAGDA-platform stelt tal van webservices voor punctuele bevraging ter beschikking. Deze en onderliggende pagina’s schetsen het algemene kader van deze MAGDA webservices, het proces, foutafhandeling, opbouw verzoek/repliek, ... .
Voor een overzicht van alle beschikbare MAGDA-diensten wordt verwezen naar Handleidingen dienstenaanbod.
Informatie:Elke MAGDA webservice is beschikbaar in een batch-variant. Voor meer informatie: Webservice In Batch bevragen. |
Voor de ontsluiting van een MAGDA webservice moet aan enkele voorwaarden voldaan zijn alsook moet de afnemer over de nodige informatie beschikken. Hieronder alvast enkele aandachtspunten.
Vooraleer een afnemer MAGDA diensten kan gebruiken, moet die de MAGDA Toelatingsprocedure doorlopen. Deze procedure zorgt ervoor dat de afnemer wordt geregistreerd als gerechtigd gebruiker van één of meerdere MAGDA diensten. De afnemer krijgt daarbij de nodige codes en richtlijnen voor het aanroepen van de diensten, waaronder een URI (unieke identificatie van de afnemer) en hoedanigheidscode (identificeert in welke context de afnemer een dienst wenst te gebruiken).
Voor meer informatie: Aansluitingsproces MAGDA
Authenticatie van de afnemer naar MAGDA gebeurt aan de hand van certificaten. Vlaamse entiteiten en Lokale besturen kunnen gebruik maken van VO-DCB voor de aanmaak en het beheren van hun certificaten, tijdens het aansluitingsproces zullen de nodige CN vrijgegeven worden in de VO-DCB toepassing.
Zie Certificaten voor meer informatie.
Voor het gebruik van de MAGDA webservices zijn de nodige XSD's en WSDL's beschikbaar. De XSD's zijn terug te vinden op de pagina Overzicht endpoints en XSD's.
De swagger bestanden die gebruikt worden bij de MAGDA REST diensten zijn te vinden op MAGDA Swaggers voor REST diensten
Elke webservice kent twee endpoints nl: T&I en Productie. Deze endpoints worden bekomen tijdens het aansluitingsproces.