- Created by Laurens Debackere on 29 Aug, 2018
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
Version 1 Next »
Informatie:
Voor de ontsluiting van een MAGDA 2.0 webservice, alsook het generieke proces binnen een 2.0 webservice, wordt verwezen naar Werking en gebruik MAGDA 2.0 Webservices.
De webservice GeefPasfoto 2.0 laat een gemachtigde afnemer van het MAGDA platform toe de pasfoto van een persoon, die bewaard wordt door het Rijksregister, op te halen. Dit gebeurt op basis van het INSZ van deze persoon.
Wijzigingshistoriek
| Datum | Aanpassingen |
|---|---|
| Importeren van de handleiding in Confluence |
Situering
Deze dienst kadert binnen het domein Persoon van het MAGDA platform.
Verwante diensten
Om deze webservice te kunnen gebruiken moet er eerst een inschrijving in het MAGDA inschrijvingsrepertorium voor personen aangemaakt worden. Deze inschrijvingen kunnen toegevoegd en verwijderd worden via de webservice BeheerInschrijving.
Gegevensbronnen
De authentieke bron van de gegevens is het Rijksregister.
Voor meer informatie met betrekking tot de inhoud van de persoonsgegevens wordt verwezen naar de Rijksregister onderrichtingen terug te vinden via volgende URL: http://www.ibz.rrn.fgov.be/index.php?id=2485&L=1
Meer informatie over hoe deze bronnen gebruikt worden in de opbouw van het antwoord vindt u onder Opvraging.
Opmerking:
Agentschap Informatie Vlaanderen is afhankelijk van de Federale bron voor de kwaliteit en de aanlevering van de gegevens.
Gebruiksvoorwaarden
Afnemers moeten aan volgende voorwaarden voldoen om deze dienst te mogen gebruiken:
- Toelating tot het MAGDA platform
- Machtiging van het sectoraal comité van het Rijksregister
Informatie:
Meer informatie over deze voorwaarden is terug te vinden op de pagina “Machtigingen en toelatingen”.
Batch
Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML). Voor meer informatie: Webservice In Batch bevragen.
| Prefix | GPRD |
|---|---|
| Voorbeeld | GPRD_20131103115553530.XML |
Functionaliteiten
Vraag
De afnemer vermeldt in de vraag het INSZ van de persoon waarvoor de pasfoto dient opgevraagd te worden.
Antwoord
Eens de afnemer de request gelanceerd heeft wordt de vraag doorgestuurd naar het Rijksregister. MAGDA ontvangt het antwoord van Rijksregister en geeft dit terug als een ‘Pasfoto’.
Deze Pasfoto van MAGDA is in hetzelfde formaat als hoe de pasfoto van het Rijksregister wordt verkregen, namelijk in zgn. ‘Base 64’ formaat.
Base 64 is een veel gebruikte methode om binaire data te converteren naar ASCII tekens en omgekeerd. Concreet betekent dit dat de geleverde pasfoto zal bestaan uit een reeks tekens die een afnemer met een Base 64 decoder zelf terug kan omzetten naar een pasfoto. MAGDA voorziet geen Base 64 decoder maar deze zijn vrij verkrijgbaar.
Naast de pasfoto levert de dienst ook de datum waarop de pasfoto voor het laatst is aangepast.
Werking
Aandachtspunten
Opties
Volgende configuratieparameters kunnen ingesteld worden in functie van de machtigingen en de wensen van de afnemer:
- Configuratieparameters op het MAGDA platform zijn voor deze dienst niet van toepassing
Opvraging
Van zodra de vraag gesteld is wordt er een XSD-validatie uitgevoerd. Is de ontvangen vraag XML niet geldig tegenover het schema, dan stopt de verwerking en wordt een foutmelding aangemaakt, anders gaat de verwerking verder.
Na de XSD-validatie vinden de nodige authenticatie- en autorisatiecontroles plaats, bijvoorbeeld de inschrijvingscontrole.
Hierna vindt er een functionele validatie plaats van de vraag (bijvoorbeeld checksum 97 op het INSZ)
Nadien zal de webservice achterliggend ‘transactie 08’ bij het Rijksregister oproepen. Dit is de dienst van het Rijksregister die een pasfoto kan leveren. Ontvangt de webservice een antwoord – hetzij de pasfoto, hetzij een foutcode – wordt dit gevalideerd en omgezet in een MAGDA XML formaat. Het antwoord wordt nogmaals gevalideerd waarna het aan de afnemer ter beschikking gesteld wordt.
Responsetijden & Beschikbaarheid
De webservice op het MAGDA platform is 24 uur op 24 en 7 dagen op 7 beschikbaar. De beschikbaarheid van de gegevens is echter volledig afhankelijk van Rijksregister die in principe 24/7 beschikbaar is.
Bij geplande onbeschikbaarheden van het Rijksregister worden de afnemers op de hoogte gebracht via mail. Bij een onverwachte onbeschikbaarheid wordt in het mate van het mogelijk een mail uitgestuurd (dit is als Informatie Vlaanderen zelf op de hoogte gebracht wordt door Rijksregister).
Opmerking:
De MAGDA response tijden zijn heel sterk afhankelijk van de response tijden van de bron. Als de brongegevens heel traag worden aangeleverd kan het MAGDA antwoord niet snel worden aangeleverd.
Logging
De opvragingen die gebeuren via deze webservice worden bewaard zoals beschreven op de pagina "MAGDA logging".
Op deze pagina
Binnen deze handleiding
Omgevingsinformatie
| Functioneel Domein | Persoon |
|---|---|
| Classificatie | Privacygevoelig |
Verwante diensten
-
Page:Persoon (MAGDA Gebruikersomgeving) —
GET persoon/handtekeningen-v1
De GET persoon.handtekeningen REST dienst laat toe om de handtekening, zoals ze op de identiteitskaart staat, als een afbeelding op te vragen bij Rijksregister.
Person
person/officialDocuments
De REST dienst officialDocuments laat toe om de Database Acten Burgerlijke Stand (DABS) bij FodJustitie te raadplegen.
Persoon.CreeerBIS-02.02
Deze dienst is een herwerking van de CreeerBIS-02.00 naar aanleiding van de KSZ v4 services upgrade. Het laat een gebruiker toe om de persoonsgegevens van een persoon in een KSZ-register te creëren.
Persoon.GeefAttest-02.00
Tot heel recent in 2017 was er geen reglementaire basis voor uittreksels en getuigschriften van het bevolkingsregister. Dit verklaart de grote verscheidenheid aan attesten en terminologie die werden (en vaak nog worden) aangeboden door de gemeenten. Door het Ministerieel besluit van 21 APRIL 2017 is hier verandering in gekomen. Dit Ministerieel besluit bepaalt de exhaustieve lijst en de modellen van de bevolkingsattesten.
Persoon.GeefGezinssamenstelling-02.02
Deze dienst is een uitbreiding op de GeefGezinssamenstelling-02.00 naar aanleiding van de KSZ v4 services upgrade. Het laat een gebruiker toe om de gezinssamenstelling van een persoon en de persoonsgegevens van de ingevoerde persoon of gezinsleden op te vragen bij de KSZ.
Persoon.GeefHistoriekGezinssamenstelling-02.02
Deze dienst is een uitbreiding op de GeefHistoriekGezinssamenstelling-02.00 naar aanleiding van de KSZ v4 services upgrade. Het laat een gebruiker toe om de historiek van de gezinssamenstelling van een persoon en de persoonsgegevens van de ingevoerde persoon of gezinsleden op te vragen bij de KSZ. Dit kan op een bepaalde datum in het verleden, of vanaf een bepaalde datum in het verleden.
Persoon.GeefHistoriekPersoon-02.02
De webservice GeefHistoriekPersoon 2.02 laat de afnemer van het MAGDA-platform toe de historische gegevens van een persoon op te halen, dit op basis van het INSZ-nummer van deze persoon, bij het Rijksregister of via de KSZ.
Persoon.GeefPasfoto-02.00
De webservice GeefPasfoto 2.0 laat een gemachtigde afnemer van het MAGDA platform toe de pasfoto van een persoon, die bewaard wordt door het Rijksregister, op te halen. Dit gebeurt op basis van het INSZ van deze persoon.
Persoon.GeefPersoon-02.02
De webservice GeefPersoon 2.02 laat de afnemer van het MAGDA-platform toe de actuele gegevens van een persoon op te halen, dit op basis van het INSZ-nummer van deze persoon, bij het Rijksregister of via de KSZ.
Persoon.GeefPersoonMutatiesNotificaties-02.00
Deze webservice dient voor het afhalen van de Rijksregisternotificaties van persoonsmutaties. De persoonsgegevens zelf komen via deze publicatie niet mee. De publicatie bevat enkel de notificatie dat een bepaald persoonsgegeven (informatietype) gewijzigd, toegevoegd, of geannulleerd is. De persoonsgegevens dienen – indien nodig – opgevraagd te worden via de GeefPersoon-02.0x diensten.
Persoon.PubliceerInwonersPerAdres-V1
De dienst PubliceerInwonersPerAdres-V1 geeft afvalmaatschappijen de mogelijkheid om de hoeveelheid afval in relatie te brengen met het aantal personen op een gegeven adres binnen de NIS-codes waarvoor zij bevoegd zijn. Het doel is om aan de hand van deze gegevens de afvalroutes efficiënter te kunnen inplannen.
Persoon.PubliceerMutatieGezinssamenstelling-02.02
Deze publicatie is de opvolger van de Persoon.PubliceerMutatieGezinssamenstelling-02.00.
Het doel van deze publicatie op het MAGDA-platform is het beschikbaar stellen van de veranderingen in de gegevens van gezinnen. Deze gegevens zijn afkomstig van het Rijksregister en/of de KSZ en worden verdeeld via de KSZ naar diens partners.
Persoon.PubliceerMutatiePersoon-02.02
Deze publicatie is de opvolger van de Persoon.PubliceerMutatiePersoon-02.00.
Het doel van deze publicatie op het MAGDA-platform is het beschikbaar stellen van de veranderingen in de gegevens van bepaalde personen. Deze gegevens zijn afkomstig van het Rijksregister en/of de KSZ en worden verdeeld via de KSZ naar diens partners.
Persoon.PubliceerPersoonMutatieNotificatie-02.00
Deze service geeft publicaties van Rijksregisternotificaties van persoonsmutaties. De persoonsgegevens komen via deze publicatie niet mee. De publicatie bevat enkel de notificatie dat een bepaald persoonsgegeven (informatietype) gewijzigd, beëindigd, geannuleerd of toegevoegd is.
PersoonType-02.02
Dit document beschrijft de gegevensstructuur van het PersoonType-02.02 dat gebruikt wordt in de verschillende v02.02 persoonsdiensten.
Persoon.WijzigKSZPersoon-02.02
Deze dienst is een herwerking van de WijzigKSZPersoon-02.00 naar aanleiding van de KSZ v4 services upgrade. Het laat een gebruiker toe om de persoonsgegevens van een persoon in een KSZ-register te wijzigen.
Persoon.ZoekPersoonOpAdres-02.02
Deze dienst is een uitbreiding op de ZoekPersoonOpAdres 02.00 naar aanleiding van de KSZ v4 services upgrade. Het laat een gebruiker toe om persoon te zoeken bij KSZ of Rijksregister op basis van adresgegevens. Als resultaat wordt een lijst teruggegeven met basisgegevens van een persoon. Met deze basisgegevens kan dan de juiste persoon gezocht worden waarna op basis van het INSZ de volledige persoonsgegevens kunnen opgezocht worden met de /wiki/spaces/MDI/pages/1006668903 dienst.
Persoon.ZoekPersoonOpNaam-02.02
Deze dienst is een uitbreiding op de ZoekPersoonOpNaam-02.00 naar aanleiding van de KSZ v4 services upgrade. Het laat een gebruiker toe om een persoon te zoeken bij de KSZ of het Rijksregister op basis van een fonetische representatie van de naam. Als resultaat wordt een lijst teruggegeven met basisgegevens van een persoon. Met deze basisgegevens kan dan de juiste persoon gezocht worden waarna op basis van het INSZ de volledige persoonsgegevens kunnen opgezocht worden met de /wiki/spaces/MDI/pages/1006668903 dienst.
Veelgestelde Vragen bij de Persoonsdiensten
Deze pagina bevat antwoorden met betrekking tot frequent gestelde vragen over de MAGDA 2.0 Persoonsdiensten.
- No labels
