De Consult Service, kort voor consultatie service, laat toe om de inhoud van de Navigator Wetgeving Leefmilieu, Natuur en Energie te raadplegen.
Deze webservice is gebaseerd op het SOAP protocol, en biedt 3 mogelijke manieren om de service te bevragen.
Een logische volgorde is
- opvragen van de beschikbare boeken
- voor een gevonden boek de inhoudstafel opvragen
- voor een gevonden boek, of voor een gevonden boek onderdeel, de inhoud ophalen
De service heeft een verplichte authenticatie. Dit dient niet om de data af te schermen, maar om toezicht te kunnen houden op overdadig gebruik van de webservice. Voor vragen in verband met de login gegevens mag u ons steeds contacteren.
Version: 1
Service Description File: https://ws-navigator.emis.vito.be/milnav-ws/consultService
SoapUI Project: consultService.xml
getRegulationDesignationList
Geeft een lijst terug van alle beschikbare wetboeken.
Deze lijst bevat naast een titel en een omschrijving ook het unieke identificatie nummer, de ID.
Aan de hand van deze ID kan de verdere inhoud van een wetboek of wettekst opgehaald worden.
Version: 1
Type: SOAP
Method: POST
Authentication: Plaintext
Link: https://ws-navigator.emis.vito.be/milnav-ws/consultService
Code:
Headers
[geshifilter-pre type="text"] Accept-Encoding: gzip,deflate Content-Type: text/xml;charset=UTF-8 SOAPAction: "" Authorization: Basic XXXXXXXXXXXXXXXXXXXX Content-Length: 257 Host: ws-navigator.emis.vito.be:80 Proxy-Connection: Keep-Alive User-Agent: Apache-HttpClient/4.1.1 (java 1.5) [/geshifilter-pre]
Content
[geshifilter-pre type="xml"] <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://server.ws.milieunavigator.prj.hemmis.com/"> <soapenv:Header/> <soapenv:Body> <ser:getRegulationDesignationList/> </soapenv:Body> </soapenv:Envelope> [/geshifilter-pre]
getRegulationDesignationListResponse
Version: 1
Een voorstelling van de inhoudstafel van een wetboek.
Dit formaat is gebaseerd op de MetaLex standaard
Bevat een lijst van RegulationDesignation objecten
RegulationDesignation
De voorstelling van een wetboek zoals deze voorkomt in de navigator.
Attributen
| Attributen | Type Cardinality | Omschrijving |
|---|---|---|
| id |
ID 1 |
De unieke ID van een wet object. Formattering: prefix "id" + nummer voorbeeld: id623 |
| Veld | Type Cardinality | Omschrijving |
|---|---|---|
|
CitationDesignation
|
1 |
De omschrijving van het wetboek |
| CiteerTitle |
1 |
De titel van het wetboek |
CitationDesignation
De omschrijving van het wetboek.
| Veld | Type Cardinality | Omschrijving |
|---|---|---|
| TextVersion |
1...* |
De tekst |
CiteerTitle
De titel van het wetboek
| Veld | Type Cardinality | Omschrijving |
|---|---|---|
| TextVersion |
1...* |
De tekst |
TextVersion
Een tekst in een bepaalde taal. Kan html entiteiten bevatten. Bijvoorbeeld: &
| Attribuut | Type Cardinality | Omschrijving |
|---|---|---|
| lang |
Tekst 1 |
De taal van de tekst Mogelijke waarde:
|
Example:
[geshifilter-code type="xml"] <env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/"> <env:Header/> <env:Body> <ns3:getRegulationDesignationListResponse xmlns:ns2="http://www.emis.vito.be/navigator/milnav-toc" xmlns:ns3="http://server.ws.milieunavigator.prj.hemmis.com/"> <return> <ns2:RegulationDesignation id="id323"> <ns2:CitationDesignation> <ns2:TextVersion xml:lang="nl">Wet van 28 december 1964 op de bestrijding van de luchtverontreiniging.</ns2:TextVersion> </ns2:CitationDesignation> <ns2:CiteerTitle> <ns2:TextVersion xml:lang="nl">Wet luchtverontreiniging</ns2:TextVersion> </ns2:CiteerTitle> </ns2:RegulationDesignation> </return> </ns3:getRegulationDesignationListResponse> </env:Body> </env:Envelope> <.code>[/geshifilter-code]
getRegulationToC
Geeft de inhoudstafel van een specifiek wetboek terug, geldig op een specifieke datum.
De gebruikte datum is standaard de huidige datum, maar kan ook expliciet als parameter meegegeven worden, om een versie uit het verleden op te halen.
Parameters
| Name | Parameter | Type Cardinality | Omschrijving |
|---|---|---|---|
| date | content |
Datum 0...1 |
De datum waarop de inhoudstafel van het wetboek in werking is of was. Formaat: jjjj-mm-dd Bijvoorbeeld: 2013-03-13 Let op: in de xsd wordt deze parameter als een dateTime beschreven, maar dit zou date moeten zijn ! |
| wetboekId | content |
Nummer 1 |
De id van het wetboek waarvoor je de inhoudstafel wil opvragen. Formaat is enkel het nummer, dus zonder "id" prefix. Bijvoorbeeld: 623
|
Version: 1
Type: SOAP
Method: POST
Authentication: Plaintext
Link: https://ws-navigator.emis.vito.be/milnav-ws/consultService
Code:
Headers
[geshifilter-pre type="text"] Accept-Encoding: gzip,deflate Content-Type: text/xml;charset=UTF-8 SOAPAction: "" Authorization: Basic XXXXXXXXXXXXXXXXXXXXX Content-Length: 359 Host: ws-navigator.emis.vito.be:80 Proxy-Connection: Keep-Alive User-Agent: Apache-HttpClient/4.1.1 (java 1.5) [/geshifilter-pre]
Content
[geshifilter-pre type="xml"] <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://server.ws.milieunavigator.prj.hemmis.com/"> <soapenv:Header/> <soapenv:Body> <ser:getRegulationToC> <wetboekId>263</wetboekId> <!--Optional:--> <date></date> </ser:getRegulationToC> </soapenv:Body> </soapenv:Envelope> [/geshifilter-pre]
getRegulationToCResponse
Version: 1
Een voorstelling van de inhoudstafel van een wetboek.
Dit antwoord is gebaseerd op de MetaLex standaard
Bevat een RegulationToCType object
RegulationToCType
Attributen
| Attributen | Type Cardinality | Omschrijving |
|---|---|---|
| id |
Datum 1 |
De unieke ID van een wet object. Formattering: prefix "id" + nummer voorbeeld: id623 |
| date-version |
Datum 1 |
Datum van kracht Formaat: jjjj-mm-ddZ |
| date-publication |
Datum 1 |
Datum van publicatie Formaat: jjjj-mm-ddZ |
| date-enacted |
Datum 1 |
Datum van in werking treding Formaat: jjjj-mm-ddZ |
| date-repealed |
Datum 0...1 |
Datum van opheffing Formaat: jjjj-mm-ddZ
|
| Veld | Type Cardinality | Omschrijving |
|---|---|---|
|
CitationDesignation
|
1 |
De titel van het wetboek |
|
PartDesignation
|
0...* |
|
| ArticleDesignation |
0...* |
CitationDesignation
| Veld | Type Cardinality | Omschrijving |
|---|---|---|
| TextVersion |
1...* |
PartDesignation
Attributen
| Attributen | Type Cardinality | Omschrijving |
|---|---|---|
| id |
Datum 1 |
De unieke ID van een wet object. Formattering: prefix "id" + nummer voorbeeld: id623 |
| date-version |
Datum 1 |
Datum van kracht Formaat: jjjj-mm-ddZ |
| date-publication |
Datum 1 |
Datum van publicatie Formaat: jjjj-mm-ddZ |
| date-enacted |
Datum 1 |
Datum van in werking treding Formaat: jjjj-mm-ddZ |
| date-repealed |
Datum 0...1 |
Datum van opheffing Formaat: jjjj-mm-ddZ
|
| Veld | Type Cardinality | Omschrijving |
|---|---|---|
|
IndexDesignation
|
1 |
|
|
Title
|
1 |
|
| ArticleDesignation |
0...* |
|
| PartDesignation |
0...* |
ArticleDesignation
Attributen
| Attributen | Type Cardinality | Omschrijving |
|---|---|---|
| id |
Datum 1 |
De unieke ID van een wet object. Formattering: prefix "id" + nummer voorbeeld: id623 |
| date-version |
Datum 1 |
Datum van kracht Formaat: jjjj-mm-ddZ |
| date-publication |
Datum 1 |
Datum van publicatie Formaat: jjjj-mm-ddZ |
| date-enacted |
Datum 1 |
Datum van in werking treding Formaat: jjjj-mm-ddZ |
| date-repealed |
Datum 0...1 |
Datum van opheffing Formaat: jjjj-mm-ddZ
|
| Veld | Type Cardinality | Omschrijving |
|---|---|---|
| IndexDesignation |
1 |
|
| Title |
1 |
|
| SubPartDesignation |
0...* |
SubPartDesignation
Attributen
| Attributen | Type Cardinality | Omschrijving |
|---|---|---|
| date-version |
Datum 1 |
Datum van kracht Formaat: jjjj-mm-ddZ |
| date-publication |
Datum 1 |
Datum van publicatie Formaat: jjjj-mm-ddZ |
| date-enacted |
Datum 1 |
Datum van in werking treding Formaat: jjjj-mm-ddZ |
| date-repealed |
Datum 0...1 |
Datum van opheffing Formaat: jjjj-mm-ddZ
|
| Veld | Type Cardinality | Omschrijving |
|---|---|---|
| IndexDesignation |
1 |
|
| Title |
1 |
|
| SubPartDesignation |
0...* |
IndexDesignation
| Veld | Type Cardinality | Omschrijving |
|---|---|---|
| Category |
0...1 |
|
| Index |
1 |
Title
| Veld | Type Cardinality | Omschrijving |
|---|---|---|
| TextVersion |
1...* |
Category
| Veld | Type Cardinality | Omschrijving |
|---|---|---|
| TextVersion |
1...* |
Index
| Veld | Type Cardinality | Omschrijving |
|---|---|---|
| TextVersion |
1...* |
TextVersion
| Attribuut | Type Cardinality | Omschrijving |
|---|---|---|
| lang |
Tekst 1 |
De taal van de tekst Mogelijke waarde:
|
Example:
[geshifilter-pre type="xml"] <env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/"> <env:Header/> <env:Body> <ns3:getRegulationToCResponse xmlns:ns2="http://www.emis.vito.be/navigator/milnav-toc" xmlns:ns3="http://server.ws.milieunavigator.prj.hemmis.com/"> <return date-enacted="1995-08-01Z" date-publication="1995-07-31Z" date-version="2013-05-13Z" id="id263"> <ns2:CitationDesignation> <ns2:TextVersion xml:lang="nl">Besluit van de Vlaamse regering van 1 juni 1995 houdende algemene en sectorale bepalingen inzake milieuhygiëne</ns2:TextVersion> <ns2:TextVersion xml:lang="en">Order of the Flemish Government of 1 June 1995 concerning General and Sectoral provisions relating to Environmental Safety</ns2:TextVersion> </ns2:CitationDesignation> <ns2:PartDesignation date-enacted="1995-08-01Z" date-publication="1995-07-31Z" date-version="2013-05-13Z" id="id7911"> <ns2:IndexDesignation> <ns2:Category> <ns2:TextVersion xml:lang="nl">Deel</ns2:TextVersion> <ns2:TextVersion xml:lang="en">Part</ns2:TextVersion> </ns2:Category> <ns2:Index> <ns2:TextVersion xml:lang="nl">1.</ns2:TextVersion> <ns2:TextVersion xml:lang="en">1.</ns2:TextVersion> </ns2:Index> </ns2:IndexDesignation> <ns2:Title> <ns2:TextVersion xml:lang="nl">ALGEMENE BEPALINGEN</ns2:TextVersion> <ns2:TextVersion xml:lang="en">GENERAL PROVISIONS</ns2:TextVersion> </ns2:Title> </ns2:PartDesignation> </return> </ns3:getRegulationToCResponse> </env:Body> </env:Envelope> [/geshifilter-pre]
getRegulation
Geeft de inhoud terug van een specifiek wetobject, en alle onderliggende wetobjecten, geldig op een specifieke datum.
De gebruikte datum is standaard de huidige datum, maar kan ook expliciet als parameter meegegeven worden, om een versie uit het verleden op te halen.
Parameters
| Name | Parameter | Type Cardinality | Omschrijving |
|---|---|---|---|
| date | content |
Datum 0...1 |
De datum waarop de inhoudstafel van het wetboek in werking is of was.
Formaat: jjjj-mm-dd
Bijvoorbeeld: 2013-03-13
Let op: in de xsd wordt deze parameter als een dateTime beschreven, maar dit zou date moeten zijn !
|
| id | content |
Nummer 1 |
De id van het wetobject waarvoor je de inhoud wil opvragen.
Formaat is enkel het nummer, dus zonder "id" prefix.
Bijvoorbeeld: 623 |
Version: 1
Type: SOAP
Method: POST
Authentication: Plaintext
Link: https://ws-navigator.emis.vito.be/milnav-ws/consultService
Code:
Headers
[geshifilter-pre type="text"] Accept-Encoding: gzip,deflate Content-Type: text/xml;charset=UTF-8 SOAPAction: "" Authorization: Basic XXXXXXXXXXXXXXXXXXXXX Content-Length: 366 Host: ws-navigator.emis.vito.be:80 Proxy-Connection: Keep-Alive User-Agent: Apache-HttpClient/4.1.1 (java 1.5) [/geshifilter-pre]
Content
[geshifilter-pre type="xml"] <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://server.ws.milieunavigator.prj.hemmis.com/"> <soapenv:Header/> <soapenv:Body> <ser:getRegulation> <!--Optional:--> <id>632</id> <!--Optional:--> <date>?</date> </ser:getRegulation> </soapenv:Body> </soapenv:Envelope> [/geshifilter-pre]
getRegulationResponse
Version: 1
Een voorstelling van de inhoud van een wetobject, geldig op een specifieke datum.
Een wetobject kan een volledig wetboek zijn, een onderdeel van een wetboek, een specifiek artikel of zelfs een paragraaf.
De gebruikte datum is standaard de huidige datum, maar kan ook expliciet als parameter meegegeven worden, om een versie uit het verleden op te halen.
Let op, het antwoord is een apart xml bestand, waarvan de inhoud volledig meegegeven is. Dit wordt gedaan door de gehele inhoud als een CDATA blok mee te geven. De inhoud hiervan volgt de indeling van een RegulationToCType
getRegulationListByIndex
Geeft alle gekoppelde wetteksten terug, die gerelateerd zijn aan een specifieke thematische index.
De meest gebruikte thematische index, is deze van de rubrieken. Hierbij is de indexId gelijk aan de rubriekId.
De lijst van rubrieken, met daarin de rubriekId, kan je terugvinden via de RubriekService
Parameters
| indexId | content |
Nummer 1 |
De id van de rubriek waarvoor je de gerelateerde wetteksten wil opvragen.
Bijvoorbeeld: 3151 |
|---|
Version: 1
Type: SOAP
Method: POST
Authentication: Plaintext
Link: https://ws-navigator.emis.vito.be/milnav-ws/consultService
Code:
Headers
[geshifilter-pre type="text"] Accept-Encoding: gzip,deflate Content-Type: text/xml;charset=UTF-8 SOAPAction: "" Authorization: Basic XXXXXXXXXXXXXXXXXXXXX Content-Length: 366 Host: ws-navigator.emis.vito.be:80 Proxy-Connection: Keep-Alive User-Agent: Apache-HttpClient/4.1.1 (java 1.5) [/geshifilter-pre]
Content
[geshifilter-pre type="xml"] <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://server.ws.milieunavigator.prj.hemmis.com/"> <soapenv:Header/> <soapenv:Body> <ser:getRegulationListByIndex> <indexId>623</indexId> </ser:getRegulationListByIndex> </soapenv:Body> </soapenv:Envelope> [/geshifilter-pre]
getRegulationListByIndexResponse
Version: 1
Een voorstelling van de gekoppelde wetgeving behorend tot een thematische index.
Let op, het antwoord is een apart xml bestand, waarvan de inhoud volledig meegegeven is. Dit wordt gedaan door de gehele inhoud als een CDATA blok mee te geven. De inhoud hiervan volgt de indeling van een RegulationToCType