Deze pagina beschrijft de mogelijkheden om sensordata m.b.t. grondwater/bodem toe te voegen aan DOV.
Onderstaande lijst geeft een overzicht van de beschikbare endpoints in de REST-API Instrumenten. Klik op de link voor meer info.
De meest recente handleiding is te vinden op https://www.dov.vlaanderen.be/portaal/api/instrument/api-guide.html. Hierin zijn de meeste onderstaande endpoints terug te vinden, met hun beschikbare opties en attributen. Deze API-referentie wordt automatisch aangemaakt. In de onderstaande lijst zijn er ook een aantal endpoints terug te vinden, die nog niet gedocumenteerd staan in de API-referentie, maar die wel nuttig kunnen zijn bij het uitwerken van scripts. |
(geen documentatie beschikbaar):
(geen documentatie beschikbaar):
(geen documentatie beschikbaar):
Hieronder de PRODUCTIE versie, voor OEFEN is de basisurl https://services-oefen.dov.vlaanderen.be.
Hieronder drie endpoints die kunnen gebruikt worden om connectie en certificaten te testen
In de API-documentatie staat bij elke POST-endpoint een json-body meegegeven als voorbeeld. Dit is echter zeer uitgebreid, en bevat alle attributen. In de meeste gevallen volstaat echter een beperkte set aan attributen om nieuwe instrumenten of koppelingen aan te maken. Hieronder worden enkele beknoptere voorbeelden gegeven.
request_url = "https://services-oefen.dov.vlaanderen.be/hfmetingen/instrumenten/"
{ "metadata": { "naam": "bart_test_dolk_imdc2", "type": { "code": "TMS" }, "serienummer": "BPA1235", "referentie": "CN: " + "bart_test_dolk2", "datumInGebruik": "2020-01-01", "typeNummer": { "code": "TMS4" }, "transmissie": { "code": "MAN" } }, "objectBeheer": { "status": { "code": "4" }, "databeheerder": { "id": "8" } }, "compensatieData": {}, "sensorData": { "sensoren": [ { "naam": "SWC", "parameter": { "id": 1912 }, "sensorIdentificatie": { "code": "CN_SWC" }, "meeteenheid": { "code": 127 } }, { "naam": "T1", "parameter": { "id": 1911 }, "sensorIdentificatie": { "code": "CN_T1" }, "meeteenheid": { "code": 3 } }, { "naam": "T2", "parameter": { "id": 1911 }, "sensorIdentificatie": { "code": "CN_T2" }, "meeteenheid": { "code": 3 } }, { "naam": "T3", "parameter": { "id": 1911 }, "sensorIdentificatie": { "code": "CN_T3" }, "meeteenheid": { "code": 3 } } ] } } |
{ "metadata": { "naam": "bart_test_diver_imdc1", "type": { "code": "DIV", }, "serienummer": "BPA_1234", "referentie": "", "datumInGebruik": "2022-05-02", "typeNummer": { "code": "11110304", }, "transmissie": { "code": "GPRS", } }, "objectBeheer": { "status": { "code": "4", }, "databeheerder": { "id": "10", } }, "sensorData": { "sensoren": [{ "naam": "Waterpeil", "parameter": { "id": "1914", }, "meeteenheid": { "code": "200", } }] }, "compensatieData": {} } |
Tips:
Gekende foutmeldingen:
request_url = "https://services-oefen.dov.vlaanderen.be/hfmetingen/instrumentlink/"
{ "objectType": "BODEMLOCATIE", "instrument": { "permKey": INSTRUMENT_PERMKEY }, "bodemObjectLinkMetadataDto": { "bodemobject": { "permKey": BODEMLOCATIE_PERMKEY }, "startDiepte" : -10, "eindDiepte": 13, "koppelnaam": "barttest-01", "van": "01-11-2022 08:00:00", "tot": null, "status" : { "code": "4" } }, "partner": "8", "securityStatus": "PUBLIEK" } |
{ "objectType": "FILTER", "instrument": { "permKey": INSTRUMENT_PERMKEY }, "filterObjectLinkMetadataDto": { "filter": { "permKey": FILTER_PERMKEY }, "koppelnaam": "barttest-01", "van": "01-06-2023 08:00:00", "tot": null, "status" : { "code": "4" }, # "ophangLengte" : 6.0, # "referentie" : { # "code" : "1" # }, }, "partner": "10", "securityStatus": "PUBLIEK" } |
Tips:
Gekende foutmeldingen:
Upload van 1 datapunt (via json, synchrone verwerking), meerdere datapunten (via json, asynchrone verwerking) of een csv-bestand (asynchrone verwerking).
Over het formaat van het csv-bestand:
Voorbeeld:
2018-08-29T23:59:00.000+01:00,20.13,1
2018-08-31T14:26:00.000+01:00,20.35,1
2018-09-03T08:13:00.000+01:00,20.27,1