• Voor het downloaden van de meeste datasets is het voldoende om een API-key te gebruiken bij requests. Deze API-key dien je aan te vragen(opent in nieuw venster).
• Voor het downloaden van een aantal specifieke datasets is het wel noodzakelijk om geauthentiseerd te zijn via een Bearer token.

• De applicatie maakt gebruik van de Veiligheidsbouwstenen van de Vlaamse overheid voor het authentiseren en autoriseren van afnemers van token authenticatie (via Bearer token).
• Deze autorisatie is per product (dataset/datasetgroep) geregeld.
• Als u de catalogus (i.e. de ‘product’ resource) benadert met je OAuth token, krijgt u een indicatie of u al dan niet gemachtigd bent om de producten te downloaden.
• Voor het opvragen van productinformatie hebt u de scope “download_catalogus_v2” nodig.
• Voor het plaatsen en downloaden van een bestelling hebt u de scope “download_orders_v2” nodig.

U kunt de gedownloade gegevens beperken tot:

• een bepaald geografisch gebied (aangepast of vooraf gedefinieerd) of
• tot een bepaalde tijdsperiode.

Een enkele bestelling kan een of meer bestel-items bevatten.

Na een succesvolle validatie van de orderconfiguratie ontvangt u een order id.

Deze id kan worden gebruikt om te peilen naar voltooiing van de bestelling:

• de HEAD-methode biedt een controle voor de bestelstatus,
• terwijl de GET-methode alle details van de bestelling retourneert.

Wanneer de bestelling is voltooid, kunt u het resulterende zip-bestand downloaden.