Inleiding

Basisprincipes

Hieronder enkel basisprincipes van hoogfrequente data samengevat:

  • Hoog frequente data is steeds gekoppeld aan een sensor van een instrument. Bijvoorbeeld een druksensor van een barologger of een druksensor van een diver die de hydrostatische druk meet.

  • Een instrument kan op elk moment aan minimum 0 en maximum 1 object (bijvoorbeeld filter) gekoppeld zijn. In de tijd kan een instrument aan meerdere objecten gekoppeld worden.

  • Een meetreeks is de verzameling van hoog frequente data aan een object van een bepaald type sensor voor een bepaalde periode. Deze data kan afkomstig zijn van verschillende instrumenten die dat type sensor bevatten en in de tijd aan het object gekoppeld zijn geweest.

  • Het type van sensor wordt bepaald aan de hand van de parameter en de sensoridentificatie (deze laatste is optioneel).

De data wordt dus steeds gekoppeld aan een sensor van een instrument. Om deze data te koppelen moeten volgende gegevens gekend zijn:

  • DOV-permkey van het instrument.

  • DOV-permkey van de sensor.

"Instrument" en "Sensor"

  • Het instrument is een fysiek meettoestel.

  • Een instrument kan aan volgende objecten gekoppeld worden:

    • FILTER

    • BODEMLOCATIE

  • Een instrument kan aan 1 of meerdere objecten gekoppeld worden, maar niet in dezelfde periode.

  • Een object kan op een bepaald moment maar maximaal aan 1 instrument gekoppeld zijn.

  • Een instrument kan meerdere periodes aan een object gekoppeld worden. Bijvoorbeeld in januari en in maart.

  • Een instrument kan 1 of meerdere sensoren bevatten van een bepaald type.

    • Bijvoorbeeld een instrument kan 1 luchtdruksensor bevatten en een temperatuursensor.

    • Een instrument kan ook een afgeleide sensoren bevatten, bijvoorbeeld peilmetingen. Peilmetingen zijn een berekende waarde.

    • Aan een instrument kunnen verschillende sensoren hangen als ze maar telkens van een ander type zijn. De combinatie parameter en sensoridentificatie kan steeds maar 1 keer voorkomen aan het instrument (*)

    • Een sensoridentificatie is een codelijst die beheerbaar is bij DOV.

scheme001

(*) Indien een instrument 2 sensoren bevat die bijvoorbeeld temperatuur opmeten: Voor beide sensoren is de parameter "Temperatuur" maar de sensoridentificatie kan bijvoorbeeld "Temperatuur" en "ReferentieTemperatuur" zijn.

"Concept Meetreeks"

Een meetreeks is een verzameling van hoogfrequente data afkomstig van alle sensoren van een bepaald type van de instrumenten gekoppeld aan een object. Indien 1 of meerdere instrumenten gekoppeld zijn met een object, en de instrumenten bevatten 1 of meerdere sensoren met hoogfrequente data, wordt voor elk type sensor een meetreeks gevormd.

Bijvoorbeeld:

Instrument 1 met 2 sensoren met data: temperatuur en peilmetingen

Instrument 2 met 2 sensoren met data: luchtdruk en peilmetingen

Instrument 1 gekoppeld met Filter 1 in 2018

Instrument 2 gekoppeld met Filter 1 in 2019

Resulteert in 3 meetreeksen:

  • Een meetreeks van het type "peilmetingen" die data zal bevatten van 2018 en 2019

  • Een meetreeks van het type "Temperatuur" die data zal bevatten van 2018

  • Een meetreeks van het type "Luchtdruk" die data zal bevatten van 2019

"Concept Leesgroepen"

Beschrijving

Leesgroepen zijn verplichte metadata wanneer een instrument de status gedeeld krijgt. Indien een instrument op gedeeld wordt gezet zonder leesgroepen, zal de API een foutmelding teruggeven.

Opvragen van beschikbare leesgroepen

Er bestaan vooraf gedefinieerde leesgroepen die via een API-call kunnen worden opgehaald.

Endpoint

GET https://services.dov.vlaanderen.be/dovkernserver/base/codetabellen/leesgroepen/

Response

De API retourneert een lijst van beschikbare leesgroepen met hun respectieve id.

Voorbeeld Response:

[
    {
        "id": "123",
        "naam": "Leesgroep A"
    },
    {
        "id": "456",
        "naam": "Leesgroep B"
    }
]

Gebruik van leesgroep-id bij instrumentbeheer

Wanneer een instrument wordt aangemaakt of gewijzigd, moet de gekozen leesgroep-id worden meegegeven in het volgende JSON-formaat:

Voorbeeld Request Body:

{
    "objectBeheer": {
        ...
        "leesgroepen": {
            "id": "{{gekozenLeesgroepId}}"
        }
    }
}

Voorbeeld foutmelding

Indien geen leesgroep wordt meegegeven bij status gedeeld:

{
    "error": "Leesgroep is verplicht wanneer status op 'gedeeld' staat."
}

Dataformaat

DOV verwacht ook een specifiek formaat waaraan elk datapunt moet voldoen. Elk datapunt moet volgende gegevens bevatten:

  • Datum/tijd met tijdzone van het datapunt (yyyy-mm-ddThh:mm:ss.nnnnnn+|-hh:mm) bijvoorbeeld 2019-12-31T14:00:00.000+01:00

  • Sensorwaarde (in de eenheid die in DOV voor die sensor geregistreerd is). Bijvoorbeeld 1029.375. De eenheid wordt getoond in de sensor-tabel op de instrument-fiche in kolom "Meeteenheid".

  • Waarde die aangeeft of de waarde gevalideerd is of niet gevalideerd is. 1 = gevalideerd, 0 = niet gevalideerd.

Men kan 1 datapunt of meerdere datapunten tegelijkertijd opladen naar DOV. Meerdere punten kunnen in de request zelf doorgestuurd worden of via een CSV-bestand. Het CSV bestand is dan een kommagescheiden bestand met op elke lijn 1 meetpunt. Bijvoorbeeld

2019-12-31T14:00:00.000+01:00,1029.375,1

2019-12-31T13:00:00.000+01:00,1027.375,0

Synchroon/Assynchroon opladen

Bij het opladen van 1 punt zal dat punt onmiddellijk toegevoegd worden aan DOV (synchroon). Bij meerdere punten (zowel in de body van een POST-request of via een CSV-bestand) zal de import assynchroon verlopen.

Te allen tijde kan de status van de assynchrone import bekeken worden. Deze status (in JSON-formaat) bevat volgende gegevens:

{
    "id": 263,
    "sensorId": 2021-000001,
    "uploadTime": "16-07-2020 12:05:34",
    "auteur": "Doe John",
    "bestand": {
        "code": "251",
        "beschrijving": "Testcsv.csv"
    },
    "status": "NIET_VERWERKT",
    "startVerwerking": null,
    "eindVerwerking": null,
    "aantalMeetpunten": null,
    "type": "UPLOAD_REST_CSV",
    "messages": []
}

status : De status van de import. Mogelijke waarden zijn

  • NIET_VERWERKT

  • IN_VERWERKING

  • VERWERKT_MET_FOUTEN

  • VERWERKT_ZONDER_FOUTEN

  • VERWERKT_MET_WAARSCHUWINGEN

  • VALIDATIE_MET_FOUTEN

  • VALIDATIE_ZONDER_FOUTEN

  • VALIDATIE_MET_WAARSCHUWINGEN

Verwijderen van data

Gegevens kunnen ook verwijderd worden van een sensor door een tijdsinterval mee te geven waartussen alle meetwaarden verwijderd worden.

Hiervoor zijn volgende inputgegevens nodig:

  • DOV-permkey van het instrument (verplicht)

  • DOV-permkey van de sensor (verplicht)

  • Starttijd (niet verplicht)

  • Eindtijd (niet verplicht)

Indien de starttijd niet meegegeven is, zal alle data tot en met de eindtijd verwijderd worden. Indien de eindtijd niet meegegeven is, zal alle data vanaf de starttijd verwijderd worden. Indien geen tijd meegegeven is, zal alle data verwijderd worden. Indien zowel start- als eindtijd meegegeven wordt, zal alle data (grenzen incluis) binnen die periode verwijderd worden.

Downloaden van sensordata/meetreeksen

Er kan data aan een sensor of object (meetreeks) opgehaald worden. Het resultaat kan een JSON, CSV of ZIP zijn. Een ZIP zal steeds CSV-bestanden bevatten met data gegroepeerd per maand.

Indien data aan een sensor gedownload wordt, zijn volgende gegevens nodig:

  • DOV-permkey van het instrument

  • DOV-permkey van de sensor ( Merk op dat een sensor door heen de tijd aan meerdere objecten gekoppeld kan zijn. Je krijgt dus alle gegevens door deze sensor gemeten onanfhankelijk van de koppeling met de filter.)

Indien data aan een object (meetreeks) gedownload wordt, zijn volgende gegevens nodig:

  • DOV object type (bv FILTER),

  • DOV-permkey van het object,

  • DOV-id van het de sensor parameter,

  • Optioneel de DOV-code van de sensoridentificatie (Merk op dat doorheen de tijd meerdere sensoren aan een object gekoppeld kunnen zijn. Alle gegevens van sensoren die waarden van het gekozen sensortype kunnen opmeten worden gebundeld.)

In beide gevallen kunnen start en/of eindtijd meegegeven worden. Indien de starttijd niet meegegeven is, zal alle data tot en met de eindtijd verwijderd worden. Indien de eindtijd niet meegegeven is, zal alle data vanaf de starttijd verwijderd worden. Indien geen tijd meegegeven is, zal alle data verwijderd worden. Indien zowel start- als eindtijd meegegeven wordt, zal alle data (grenzen incluis) binnen die periode verwijderd worden.

REST-Ontsluitingen

De beschrijving van de REST API hier terug te vinden:

api.html

Putten/filters: zoeken & aanmaken

Putten en filters kunnen in de DOV verkenner via de laag "Grondwaterlocaties" teruggevonden worden.

Aanmaken van putten en filters kan, indien de gebruiker de rechten heeft, op twee manieren gebeuren:

  • Via de DOV-applicatie vanuit het portaal "Nieuwe put" om een nieuwe put aan te maken, vanuit de put-fiche kan een nieuwe filter aangemaakt worden.

  • Via XDOV: Op basis van een XML gestructureerd volgens een gekend formaat in DOV kan een put en/of filter toegevoegd worden aan DOV.

Bodemlocaties: zoeken & aanmaken

Bodemlocaties kunnen in de DOV verkenner via de laag "Bodemlocaties" teruggevonden worden.

Aanmaken van bodemlocatie kan, indien de gebruiker de rechten heeft, op twee manieren gebeuren:

  • Via de DOV-applicatie vanuit het portaal "Nieuwe bodemlocatie".

  • Via XDOV: Op basis van een XML gestructureerd volgens een gekend formaat in DOV kan een bodemlocatie toegevoegd worden aan DOV.

Instrumenten/sensoren: zoeken & aanmaken

Indien de gebruiker rechten heeft kan op het DOV-portaal via een link "Beheer instrumenten" onder subtitel "Grondwater" een pagina geopend worden waar instrumenten kunnen aangemaakt en bekeken worden. In een instrument-fiche kan een sensor aangemaakt worden.

Use-Cases Demo project Hoog Frequente metingen

Op de github-pagina van DOV (https://github.com/DOV-Vlaanderen/dov-services-quickstart) staat een demoproject dat kan helpen om via eigen code hoog frequente data naar DOV te zenden. De code van hoog frequente metingen staat onder het package "hfmetingen".

De demo-applicatie toont alle mogelijke situaties en deze zullen hieronder beschreven worden.

Hieronder zijn de productie URL’s gebruikt. Er zijn ook url’s voor

oefen: https://services-oefen.dov.vlaanderen.be
productie: https://services.dov.vlaanderen.be

Bij het gebruiken van de endpoints in de demo’s mag er geen systeemgebruiker met alle rollen gebruikt worden, dan wordt er een jwt token aangemaakt dat te lang is en dat zorgt voor problemen op de server.

Demo 1: Healthcheck

Hier gebeurt een call om te controleren of de services beschikbaar zijn en of de security in orde is (certificaten,…​).

GET /chucknorris

Voorbeeld request

GET /chucknorris HTTP/1.1
Host: services.dov.vlaanderen.be:8080

Voorbeeld curl commando

$ curl 'https://services.dov.vlaanderen.be/dovinstrumentserver/chucknorris' -i -X GET

Voorbeeld request body

leeg

Voorbeeld response body: succes

HTTP/1.1 200 OK
Content-Type: text/plain;charset=UTF-8
Content-Length: 43

Chuck Norris is the reason Waldo is hiding.

Demo 2: Verkrijgen van de basis informatie van een instrument

Get

GET /hfmetingen/instrumenten/{idOrPermkey}

Path parameters

Parameter Type Optioneel Beschrijving

idOrPermkey

String

false

Query parameters

Geen parameters.

Voorbeeld request

GET /base/instrumenten/2021-000092 HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Accept: application/json
Host: services.dov.vlaanderen.be:8080

Voorbeeld curl commando

$ curl 'https://services.dov.vlaanderen.be/hfmetingen/instrumenten/2021-000092' -i -X GET \
    -H 'Content-Type: application/x-www-form-urlencoded' \
    -H 'Accept: application/json'

Voorbeeld request body

leeg

Voorbeeld response body: succes

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 10226

{
  "id" : 97,
  "permKey" : "2021-000092",
  "metadata" : {
    "id" : 97,
    "naam" : "IMPORT_JSY_1",
    "type" : {
      "code" : "TMS-NB",
      "beschrijving" : "Temperature Moisture Sensor - NarrowBand"
    },
    "serienummer" : "IMP_1_DOLK",
    "referentie" : "Import curieuzeneuze dolk",
    "datumInGebruik" : "2021-03-01T00:00:00.000+00:00",
    "datumUitGebruik" : null,
    "typeNummer" : {
      "code" : "CN_ONB",
      "beschrijving" : "Curieuzeneuze Onbekend",
      "merk" : {
        "code" : "CN_DLK",
        "beschrijving" : "GazonDolk",
        "fabrikant" : {
          "code" : "CN",
          "beschrijving" : "Curieuzeneuze"
        }
      },
      "instrumentType" : null
    },
    "locatieStatus" : null,
    "batterijLaatstVervangen" : null,
    "transmissie" : null
  },
  "objectBeheer" : {
    "id" : 98,
    "status" : {
      "code" : "4",
      "beschrijving" : "Publiek"
    },
    "databeheerder" : {
      "id" : "8",
      "kbonummer" : null,
      "ovocode" : null,
      "naam" : "VMM"
    },
    "leesgroepen" : null
  },
  "sensorData" : {
    "instrument" : {
      "id" : "97",
      "permKey" : "2021-000092",
      "domainObjectType" : null,
      "naam" : "IMPORT_JSY_1",
      "objectBeheer" : {
        "id" : 98,
        "status" : {
          "code" : "4",
          "beschrijving" : "Publiek"
        },
        "databeheerder" : {
          "id" : "8",
          "kbonummer" : null,
          "ovocode" : null,
          "naam" : "VMM"
        },
        "leesgroepen" : null
      }
    },
    "sensoren" : [ {
      "id" : 112,
      "permKey" : "2021-000084",
      "naam" : "SWC1",
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "parameter" : {
        "id" : "CN_SWC",
        "korteNaam" : null,
        "beschrijving" : null,
        "betekenis" : null,
        "volgnummer" : null,
        "parametergroep" : null,
        "meeteenheid" : null,
        "bovengrens" : null,
        "ondergrens" : null,
        "displayformat" : null,
        "casRegistryNumber" : null,
        "ecNumber" : null,
        "valueType" : null,
        "fixed" : false,
        "analysemethodes" : [ ],
        "standaardgroepen" : [ ],
        "meeteenheden" : [ ],
        "keuzeLijst" : null,
        "meetpuntParameter" : null,
        "meetwaardeParameter" : null,
        "primair" : false,
        "secundair" : false
      },
      "sensorIdentificatie" : {
        "code" : "CN_SWC",
        "beschrijving" : "Curieuzeneuzen volumetrisch vochtgehalte X",
        "instrumentType" : {
          "code" : "TMS-NB",
          "beschrijving" : "Temperature Moisture Sensor - NarrowBand"
        }
      },
      "meeteenheid" : {
        "code" : "127",
        "beschrijving" : null,
        "afkorting" : null
      },
      "aantalDataPunten" : 0,
      "eersteData" : null,
      "laatsteData" : null,
      "laatsteImportLog" : null,
      "nauwkeurigheid" : null,
      "precisie" : null,
      "meetbereikVan" : null,
      "meetbereikTot" : null,
      "businessKey" : "SWC1"
    }, {
      "id" : 113,
      "permKey" : "2021-000085",
      "naam" : "T1",
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "parameter" : {
        "id" : "4017",
        "korteNaam" : null,
        "beschrijving" : null,
        "betekenis" : null,
        "volgnummer" : null,
        "parametergroep" : null,
        "meeteenheid" : null,
        "bovengrens" : null,
        "ondergrens" : null,
        "displayformat" : null,
        "casRegistryNumber" : null,
        "ecNumber" : null,
        "valueType" : null,
        "fixed" : false,
        "analysemethodes" : [ ],
        "standaardgroepen" : [ ],
        "meeteenheden" : [ ],
        "keuzeLijst" : null,
        "meetpuntParameter" : null,
        "meetwaardeParameter" : null,
        "primair" : false,
        "secundair" : false
      },
      "sensorIdentificatie" : {
        "code" : "CN_T1",
        "beschrijving" : "Curieuzeneuzen temperatuur boven maaiveld",
        "instrumentType" : {
          "code" : "TMS-NB",
          "beschrijving" : "Temperature Moisture Sensor - NarrowBand"
        }
      },
      "meeteenheid" : {
        "code" : "3",
        "beschrijving" : null,
        "afkorting" : null
      },
      "aantalDataPunten" : 0,
      "eersteData" : null,
      "laatsteData" : null,
      "laatsteImportLog" : null,
      "nauwkeurigheid" : null,
      "precisie" : null,
      "meetbereikVan" : null,
      "meetbereikTot" : null,
      "businessKey" : "T1"
    }, {
      "id" : 114,
      "permKey" : "2021-000086",
      "naam" : "T2",
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "parameter" : {
        "id" : "4017",
        "korteNaam" : null,
        "beschrijving" : null,
        "betekenis" : null,
        "volgnummer" : null,
        "parametergroep" : null,
        "meeteenheid" : null,
        "bovengrens" : null,
        "ondergrens" : null,
        "displayformat" : null,
        "casRegistryNumber" : null,
        "ecNumber" : null,
        "valueType" : null,
        "fixed" : false,
        "analysemethodes" : [ ],
        "standaardgroepen" : [ ],
        "meeteenheden" : [ ],
        "keuzeLijst" : null,
        "meetpuntParameter" : null,
        "meetwaardeParameter" : null,
        "primair" : false,
        "secundair" : false
      },
      "sensorIdentificatie" : {
        "code" : "CN_T2",
        "beschrijving" : "Curieuzeneuzen temperatuur op maaiveld",
        "instrumentType" : {
          "code" : "TMS-NB",
          "beschrijving" : "Temperature Moisture Sensor - NarrowBand"
        }
      },
      "meeteenheid" : {
        "code" : "3",
        "beschrijving" : null,
        "afkorting" : null
      },
      "aantalDataPunten" : 0,
      "eersteData" : null,
      "laatsteData" : null,
      "laatsteImportLog" : null,
      "nauwkeurigheid" : null,
      "precisie" : null,
      "meetbereikVan" : null,
      "meetbereikTot" : null,
      "businessKey" : "T2"
    } ],
    "id" : 97
  },
  "compensatieData" : {
    "instrument" : {
      "id" : "97",
      "permKey" : "2021-000092",
      "domainObjectType" : null,
      "naam" : "IMPORT_JSY_1",
      "objectBeheer" : {
        "id" : 98,
        "status" : {
          "code" : "4",
          "beschrijving" : "Publiek"
        },
        "databeheerder" : {
          "id" : "8",
          "kbonummer" : null,
          "ovocode" : null,
          "naam" : "VMM"
        },
        "leesgroepen" : null
      }
    },
    "compensaties" : [ {
      "id" : 41,
      "sensor" : {
        "id" : "113",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : "T1",
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "van" : "01-05-2021 00:00:00",
      "tot" : null,
      "compensatie" : {
        "code" : "CAP",
        "beschrijving" : "Gecompenseerd via capillair"
      },
      "businessKey" : "T1"
    }, {
      "id" : 42,
      "sensor" : {
        "id" : "115",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : "T3",
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "van" : "02-05-2021 00:00:00",
      "tot" : "04-05-2021 00:00:00",
      "compensatie" : {
        "code" : "NT",
        "beschrijving" : "Niet gecompenseerd"
      },
      "businessKey" : "T3"
    } ],
    "id" : 97
  }
}

Beschrijving velden in de resonse body

Path Type Optioneel Beschrijving

id

Integer

true

Technisch id.

permKey

String

true

Permanente identifier.

metadata.id

Integer

true

Technisch id.

metadata.naam

String

true

Het veld mag niet leeg zijn.
Size must be between 0 and 100 inclusive.

metadata.type.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

metadata.type.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

metadata.serienummer

String

true

Het veld mag niet leeg zijn.
Size must be between 0 and 50 inclusive.

metadata.referentie

String

true

Size must be between 0 and 50 inclusive.

metadata.typeNummer.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 50 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

metadata.typeNummer.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 100 karakters zijn.

metadata.typeNummer.merk.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 50 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

metadata.typeNummer.merk.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 100 karakters zijn.

metadata.typeNummer.merk.fabrikant.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 50 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

metadata.typeNummer.merk.fabrikant.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

metadata.typeNummer.instrumentType.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

metadata.typeNummer.instrumentType.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

metadata.locatieStatus.code

String

false

Unieke identificatie van het element.

metadata.locatieStatus.beschrijving

String

false

Beschrijving van het element.

metadata.transmissie.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

metadata.transmissie.beschrijving

String

false

Beschrijving van het element.

objectBeheer.id

Integer

true

Technisch id.

objectBeheer.status.code

String

false

Unieke identificatie van het element.

Veld mag geen spaties bevatten.
code moet 1 tot 10 karakters zijn.

objectBeheer.status.beschrijving

String

false

Beschrijving van het element.

beschrijving moet 1 tot 50 karakters zijn.

objectBeheer.databeheerder.id

String

true

Technisch id.

objectBeheer.leesgroepen.id

String

true

Technisch id.

objectBeheer.leesgroepen.leden[].id

String

true

Technisch id.

sensorData.instrument.id

String

true

Technisch id.

sensorData.instrument.permKey

String

true

Permanente identifier.

sensorData.instrument.domainObjectType

String

true

Moet 1 van volgende waarden zijn [BORING, DOSSIER, OPDRACHT, INTERPRETATIE, SONDERING, XML, PUT, TYPEPUT, GWLOCATIE, FILTER, FILTERGROEP, TYPEFILTER, WATERMONSTER, GRONDMONSTER, MONSTER, PERCEELANALYSE, BODEMSITE, BODEMLOCATIE, EXPLOITANT, IIOA, IIOA_BESLISSING, INSTALLATIE, VERGUNNING, VERGUNNING_PROCEDURE, VERGUNNING_MASTER, BODEMCLASSIFICATIE_BE, BODEMCLASSIFICATIE_WRB, BODEMCLASSIFICATIE_EXTRA, BODEMKUNDIGEOPBOUW, BODEMDIEPTEINTERVAL, BODEMMONSTER, BODEMOBSERVATIE, BODEMOBSERVATIEPLAN, VOORAFMELDING, NULMELDING, BEMALING, INSTRUMENT, SENSOR, TERREINVINPROEF, GEOLABOPROEVEN, VOLUMEMASSA, WATERGEHALTE, SAMENDRUKKING, LABOVIN, TRIAXIAAL, GEOCORE, BOORMEESTEROPLEIDING, BOORBEDRIJF, OBSERVATIE, UNKNOWN].

sensorData.instrument.objectBeheer.id

Integer

true

Technisch id.

sensorData.instrument.objectBeheer.status.code

String

false

Unieke identificatie van het element.

Veld mag geen spaties bevatten.
code moet 1 tot 10 karakters zijn.

sensorData.instrument.objectBeheer.status.beschrijving

String

false

Beschrijving van het element.

beschrijving moet 1 tot 50 karakters zijn.

sensorData.instrument.objectBeheer.databeheerder.id

String

true

Technisch id.

sensorData.instrument.objectBeheer.leesgroepen.id

String

true

Technisch id.

sensorData.instrument.objectBeheer.leesgroepen.leden[].id

String

true

Technisch id.

sensorData.sensoren[].id

Integer

true

Technisch id.

sensorData.sensoren[].permKey

String

true

Permanente identifier.

sensorData.sensoren[].naam

String

false

Het veld mag niet leeg zijn.
Size must be between 0 and 100 inclusive.

sensorData.sensoren[].instrument.id

String

true

Technisch id.

sensorData.sensoren[].instrument.permKey

String

true

Permanente identifier.

sensorData.sensoren[].instrument.domainObjectType

String

true

Moet 1 van volgende waarden zijn [BORING, DOSSIER, OPDRACHT, INTERPRETATIE, SONDERING, XML, PUT, TYPEPUT, GWLOCATIE, FILTER, FILTERGROEP, TYPEFILTER, WATERMONSTER, GRONDMONSTER, MONSTER, PERCEELANALYSE, BODEMSITE, BODEMLOCATIE, EXPLOITANT, IIOA, IIOA_BESLISSING, INSTALLATIE, VERGUNNING, VERGUNNING_PROCEDURE, VERGUNNING_MASTER, BODEMCLASSIFICATIE_BE, BODEMCLASSIFICATIE_WRB, BODEMCLASSIFICATIE_EXTRA, BODEMKUNDIGEOPBOUW, BODEMDIEPTEINTERVAL, BODEMMONSTER, BODEMOBSERVATIE, BODEMOBSERVATIEPLAN, VOORAFMELDING, NULMELDING, BEMALING, INSTRUMENT, SENSOR, TERREINVINPROEF, GEOLABOPROEVEN, VOLUMEMASSA, WATERGEHALTE, SAMENDRUKKING, LABOVIN, TRIAXIAAL, GEOCORE, BOORMEESTEROPLEIDING, BOORBEDRIJF, OBSERVATIE, UNKNOWN].

sensorData.sensoren[].instrument.objectBeheer.id

Integer

true

Technisch id.

sensorData.sensoren[].instrument.objectBeheer.status.code

String

false

Unieke identificatie van het element.

Veld mag geen spaties bevatten.
code moet 1 tot 10 karakters zijn.

sensorData.sensoren[].instrument.objectBeheer.status.beschrijving

String

false

Beschrijving van het element.

beschrijving moet 1 tot 50 karakters zijn.

sensorData.sensoren[].instrument.objectBeheer.databeheerder.id

String

true

Technisch id.

sensorData.sensoren[].instrument.objectBeheer.leesgroepen.id

String

true

Technisch id.

sensorData.sensoren[].instrument.objectBeheer.leesgroepen.leden[].id

String

true

Technisch id.

sensorData.sensoren[].parameter.id

String

true

Technisch id.

sensorData.sensoren[].parameter.korteNaam

String

false

Korte naam moet 1 tot 50 karakters zijn.

sensorData.sensoren[].parameter.beschrijving

String

false

Beschrijving van het element.

Bechrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].parameter.parametergroep.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Veld mag geen spaties bevatten.

sensorData.sensoren[].parameter.parametergroep.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 100 karakters zijn.

sensorData.sensoren[].parameter.parametergroep.groepType

String

true

Moet 1 van volgende waarden zijn [W, G, B].

sensorData.sensoren[].parameter.meeteenheid.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Veld mag geen spaties bevatten.

sensorData.sensoren[].parameter.meeteenheid.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].parameter.meeteenheid.afkorting

String

false

Afkorting moet 1 tot 25 karakters zijn.

sensorData.sensoren[].parameter.displayformat

String

true

Weergave mag maximum 20 karakters zijn.

sensorData.sensoren[].parameter.casRegistryNumber

String

true

CAS nummer mag maximum 12 karakters zijn.

sensorData.sensoren[].parameter.ecNumber

String

true

EG-nummer mag maximum 9 karakters zijn.

sensorData.sensoren[].parameter.valueType

String

true

Moet 1 van volgende waarden zijn [NUM, TXT, BLANCO, REF, TM, MR, TMR].

sensorData.sensoren[].parameter.analysemethodes[].code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Veld mag geen spaties bevatten.

sensorData.sensoren[].parameter.analysemethodes[].beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].parameter.analysemethodes[].secundaireParameters[].id

String

true

Technisch id.

sensorData.sensoren[].parameter.standaardgroepen[].code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Veld mag geen spaties bevatten.

sensorData.sensoren[].parameter.standaardgroepen[].beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].parameter.meeteenheden[].id

String

true

Technisch id.

sensorData.sensoren[].parameter.meeteenheden[].meetEenheid.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Veld mag geen spaties bevatten.

sensorData.sensoren[].parameter.meeteenheden[].meetEenheid.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].parameter.meeteenheden[].meetEenheid.afkorting

String

false

Afkorting moet 1 tot 25 karakters zijn.

sensorData.sensoren[].parameter.meeteenheden[].omrekeningsformule

String

true

Moet 1 van volgende waarden zijn [LIN].

sensorData.sensoren[].parameter.meeteenheden[].displayformatNaam

String

true

Weergave mag maximum 10 karakters zijn.

sensorData.sensoren[].parameter.keuzeLijst[].code

String

true

Unieke identificatie van het element.

sensorData.sensoren[].parameter.keuzeLijst[].beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].sensorIdentificatie.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

sensorData.sensoren[].sensorIdentificatie.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].sensorIdentificatie.instrumentType.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

sensorData.sensoren[].sensorIdentificatie.instrumentType.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].meeteenheid.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Veld mag geen spaties bevatten.

sensorData.sensoren[].meeteenheid.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].meeteenheid.afkorting

String

false

Afkorting moet 1 tot 25 karakters zijn.

sensorData.sensoren[].laatsteImportLog.id

Integer

true

Technisch id.

sensorData.sensoren[].laatsteImportLog.bestand.code

String

false

Unieke identificatie van het element.

sensorData.sensoren[].laatsteImportLog.bestand.beschrijving

String

false

Beschrijving van het element.

sensorData.sensoren[].laatsteImportLog.status

String

true

Moet 1 van volgende waarden zijn [NIET_VERWERKT, IN_VERWERKING, VERWERKT_MET_FOUTEN, VERWERKT_ZONDER_FOUTEN, VERWERKT_MET_WARNING, GEVALIDEERD_MET_FOUTEN, GEVALIDEERD_ZONDER_FOUTEN, GEVALIDEERD_MET_WARNING].

sensorData.sensoren[].laatsteImportLog.type

String

true

Moet 1 van volgende waarden zijn [UPLOAD_GUI_CSV, UPLOAD_REST_JSON, UPLOAD_REST_CSV, DELETE_GUI, DELETE_REST].

sensorData.sensoren[].laatsteImportLog.messages[].id

Integer

true

Technisch id.

sensorData.sensoren[].laatsteImportLog.messages[].severity

String

true

Moet 1 van volgende waarden zijn [FATAL, WARNING].

sensorData.sensoren[].nauwkeurigheid

Decimal

true

Must be at least 0.
Must be at most 100.
Must have at most 3 integral digits and 2 fractional digits.

sensorData.sensoren[].precisie

Decimal

true

Must be at least 0.
Must have at most 7 integral digits and 8 fractional digits.

sensorData.sensoren[].meetbereikVan

Decimal

true

Must have at most 7 integral digits and 8 fractional digits.

sensorData.sensoren[].meetbereikTot

Decimal

true

Must have at most 7 integral digits and 8 fractional digits.

sensorData.id

Integer

true

Technisch id.

compensatieData.instrument.id

String

true

Technisch id.

compensatieData.instrument.permKey

String

true

Permanente identifier.

compensatieData.instrument.domainObjectType

String

true

Moet 1 van volgende waarden zijn [BORING, DOSSIER, OPDRACHT, INTERPRETATIE, SONDERING, XML, PUT, TYPEPUT, GWLOCATIE, FILTER, FILTERGROEP, TYPEFILTER, WATERMONSTER, GRONDMONSTER, MONSTER, PERCEELANALYSE, BODEMSITE, BODEMLOCATIE, EXPLOITANT, IIOA, IIOA_BESLISSING, INSTALLATIE, VERGUNNING, VERGUNNING_PROCEDURE, VERGUNNING_MASTER, BODEMCLASSIFICATIE_BE, BODEMCLASSIFICATIE_WRB, BODEMCLASSIFICATIE_EXTRA, BODEMKUNDIGEOPBOUW, BODEMDIEPTEINTERVAL, BODEMMONSTER, BODEMOBSERVATIE, BODEMOBSERVATIEPLAN, VOORAFMELDING, NULMELDING, BEMALING, INSTRUMENT, SENSOR, TERREINVINPROEF, GEOLABOPROEVEN, VOLUMEMASSA, WATERGEHALTE, SAMENDRUKKING, LABOVIN, TRIAXIAAL, GEOCORE, BOORMEESTEROPLEIDING, BOORBEDRIJF, OBSERVATIE, UNKNOWN].

compensatieData.instrument.objectBeheer.id

Integer

true

Technisch id.

compensatieData.instrument.objectBeheer.status.code

String

false

Unieke identificatie van het element.

Veld mag geen spaties bevatten.
code moet 1 tot 10 karakters zijn.

compensatieData.instrument.objectBeheer.status.beschrijving

String

false

Beschrijving van het element.

beschrijving moet 1 tot 50 karakters zijn.

compensatieData.instrument.objectBeheer.databeheerder.id

String

true

Technisch id.

compensatieData.instrument.objectBeheer.leesgroepen.id

String

true

Technisch id.

compensatieData.instrument.objectBeheer.leesgroepen.leden[].id

String

true

Technisch id.

compensatieData.compensaties[].id

Integer

true

Technisch id.

compensatieData.compensaties[].sensor.id

String

true

Technisch id.

compensatieData.compensaties[].sensor.permKey

String

true

Permanente identifier.

compensatieData.compensaties[].sensor.domainObjectType

String

true

Moet 1 van volgende waarden zijn [BORING, DOSSIER, OPDRACHT, INTERPRETATIE, SONDERING, XML, PUT, TYPEPUT, GWLOCATIE, FILTER, FILTERGROEP, TYPEFILTER, WATERMONSTER, GRONDMONSTER, MONSTER, PERCEELANALYSE, BODEMSITE, BODEMLOCATIE, EXPLOITANT, IIOA, IIOA_BESLISSING, INSTALLATIE, VERGUNNING, VERGUNNING_PROCEDURE, VERGUNNING_MASTER, BODEMCLASSIFICATIE_BE, BODEMCLASSIFICATIE_WRB, BODEMCLASSIFICATIE_EXTRA, BODEMKUNDIGEOPBOUW, BODEMDIEPTEINTERVAL, BODEMMONSTER, BODEMOBSERVATIE, BODEMOBSERVATIEPLAN, VOORAFMELDING, NULMELDING, BEMALING, INSTRUMENT, SENSOR, TERREINVINPROEF, GEOLABOPROEVEN, VOLUMEMASSA, WATERGEHALTE, SAMENDRUKKING, LABOVIN, TRIAXIAAL, GEOCORE, BOORMEESTEROPLEIDING, BOORBEDRIJF, OBSERVATIE, UNKNOWN].

compensatieData.compensaties[].sensor.objectBeheer.id

Integer

true

Technisch id.

compensatieData.compensaties[].sensor.objectBeheer.status.code

String

false

Unieke identificatie van het element.

Veld mag geen spaties bevatten.
code moet 1 tot 10 karakters zijn.

compensatieData.compensaties[].sensor.objectBeheer.status.beschrijving

String

false

Beschrijving van het element.

beschrijving moet 1 tot 50 karakters zijn.

compensatieData.compensaties[].sensor.objectBeheer.databeheerder.id

String

true

Technisch id.

compensatieData.compensaties[].sensor.objectBeheer.leesgroepen.id

String

true

Technisch id.

compensatieData.compensaties[].sensor.objectBeheer.leesgroepen.leden[].id

String

true

Technisch id.

compensatieData.compensaties[].instrument.id

String

true

Technisch id.

compensatieData.compensaties[].instrument.permKey

String

true

Permanente identifier.

compensatieData.compensaties[].instrument.domainObjectType

String

true

Moet 1 van volgende waarden zijn [BORING, DOSSIER, OPDRACHT, INTERPRETATIE, SONDERING, XML, PUT, TYPEPUT, GWLOCATIE, FILTER, FILTERGROEP, TYPEFILTER, WATERMONSTER, GRONDMONSTER, MONSTER, PERCEELANALYSE, BODEMSITE, BODEMLOCATIE, EXPLOITANT, IIOA, IIOA_BESLISSING, INSTALLATIE, VERGUNNING, VERGUNNING_PROCEDURE, VERGUNNING_MASTER, BODEMCLASSIFICATIE_BE, BODEMCLASSIFICATIE_WRB, BODEMCLASSIFICATIE_EXTRA, BODEMKUNDIGEOPBOUW, BODEMDIEPTEINTERVAL, BODEMMONSTER, BODEMOBSERVATIE, BODEMOBSERVATIEPLAN, VOORAFMELDING, NULMELDING, BEMALING, INSTRUMENT, SENSOR, TERREINVINPROEF, GEOLABOPROEVEN, VOLUMEMASSA, WATERGEHALTE, SAMENDRUKKING, LABOVIN, TRIAXIAAL, GEOCORE, BOORMEESTEROPLEIDING, BOORBEDRIJF, OBSERVATIE, UNKNOWN].

compensatieData.compensaties[].instrument.objectBeheer.id

Integer

true

Technisch id.

compensatieData.compensaties[].instrument.objectBeheer.status.code

String

false

Unieke identificatie van het element.

Veld mag geen spaties bevatten.
code moet 1 tot 10 karakters zijn.

compensatieData.compensaties[].instrument.objectBeheer.status.beschrijving

String

false

Beschrijving van het element.

beschrijving moet 1 tot 50 karakters zijn.

compensatieData.compensaties[].instrument.objectBeheer.databeheerder.id

String

true

Technisch id.

compensatieData.compensaties[].instrument.objectBeheer.leesgroepen.id

String

true

Technisch id.

compensatieData.compensaties[].instrument.objectBeheer.leesgroepen.leden[].id

String

true

Technisch id.

compensatieData.compensaties[].compensatie.code

String

false

Unieke identificatie van het element.

compensatieData.compensaties[].compensatie.beschrijving

String

false

Beschrijving van het element.

compensatieData.id

Integer

true

Technisch id.

Demo 3: Verkrijgen van een lijst van sensoren aan een instrument

Get

GET /hfmetingen/instrumenten/{idOrPermkey}/sensoren

Path parameters

Parameter Type Optioneel Beschrijving

idOrPermkey

String

false

Query parameters

Geen parameters.

Voorbeeld request

GET /base/instrumenten/2020-0001/sensoren HTTP/1.1
Host: services.dov.vlaanderen.be:8080

Voorbeeld curl commando

$ curl 'https://services.dov.vlaanderen.be/hfmetingen/instrumenten/2020-0001/sensoren' -i -X GET

Voorbeeld request body

leeg

Voorbeeld response body: succes

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 141

[ {
  "code" : "2021-000002",
  "beschrijving" : "Temperatuur sensor"
}, {
  "code" : "2021-000004",
  "beschrijving" : "Luchtdruksensor"
} ]

Beschrijving velden in de resonse body

Path Type Optioneel Beschrijving

[].code

String

false

Unieke identificatie van het element.

[].beschrijving

String

false

Beschrijving van het element.

Demo 4: Upload sensordata

1 datapunt

Post

POST /hfmetingen/instrumenten/{idOrPermkey}/sensoren/{sensorIdOrPermkey}/meetpunten

Path parameters
Parameter Type Optioneel Beschrijving

idOrPermkey

String

false

sensorIdOrPermkey

String

false
Query parameters
Parameter Type Optioneel Beschrijving

validation

Boolean

true

Default waarde: 'false'.
Voorbeeld request
POST /base/instrumenten/2020-0001/sensoren/2/meetpunten HTTP/1.1
Content-Type: application/json
Accept: application/json
Content-Length: 92
Host: services.dov.vlaanderen.be:8080

[ {
  "tijd" : "2020-06-11T00:00:00.000Z",
  "waarde" : 10.0,
  "status" : "GEVALIDEERD"
} ]
Voorbeeld curl commando
$ curl 'https://services.dov.vlaanderen.be/hfmetingen/instrumenten/2020-0001/sensoren/2/meetpunten' -i -X POST \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -d '[ {
  "tijd" : "2020-06-11T00:00:00.000Z",
  "waarde" : 10.0,
  "status" : "GEVALIDEERD"
} ]'
Voorbeeld request body
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 81

{
  "status" : "OK",
  "aantal" : 1,
  "foutmelding" : "",
  "importLogId" : 15
}
Voorbeeld response body: succes
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 81

{
  "status" : "OK",
  "aantal" : 1,
  "foutmelding" : "",
  "importLogId" : 15
}
Beschrijving velden in de resonse body
Path Type Optioneel Beschrijving

status

String

false

Moet 1 van volgende waarden zijn [OK, VALIDATIEFOUTEN, FOUTEN, LIMIET, VERWIJDER_FOUT, ASYNC].

Meerdere datapunten

Post

POST /hfmetingen/instrumenten/{idOrPermkey}/sensoren/{sensorIdOrPermkey}/meetpunten

Path parameters
Parameter Type Optioneel Beschrijving

idOrPermkey

String

false

sensorIdOrPermkey

String

false
Query parameters
Parameter Type Optioneel Beschrijving

validation

Boolean

true

Default waarde: 'false'.
Voorbeeld request
POST /base/instrumenten/2020-0001/sensoren/2/meetpunten HTTP/1.1
Content-Type: application/json
Accept: application/json
Content-Length: 182
Host: services.dov.vlaanderen.be:8080

[ {
  "tijd" : "2020-06-11T00:00:00.000Z",
  "waarde" : 10.0,
  "status" : "GEVALIDEERD"
}, {
  "tijd" : "2020-06-11T01:00:00.000Z",
  "waarde" : 15.0,
  "status" : "GEVALIDEERD"
} ]
Voorbeeld curl commando
$ curl 'https://services.dov.vlaanderen.be/hfmetingen/instrumenten/2020-0001/sensoren/2/meetpunten' -i -X POST \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -d '[ {
  "tijd" : "2020-06-11T00:00:00.000Z",
  "waarde" : 10.0,
  "status" : "GEVALIDEERD"
}, {
  "tijd" : "2020-06-11T01:00:00.000Z",
  "waarde" : 15.0,
  "status" : "GEVALIDEERD"
} ]'
Voorbeeld response body: succes
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 84

{
  "status" : "ASYNC",
  "aantal" : 2,
  "foutmelding" : "",
  "importLogId" : 15
}
Beschrijving velden in de resonse body
Path Type Optioneel Beschrijving

status

String

false

Moet 1 van volgende waarden zijn [OK, VALIDATIEFOUTEN, FOUTEN, LIMIET, VERWIJDER_FOUT, ASYNC].

CSV bestand

Post

POST /hfmetingen/instrumenten/{idOrPermkey}/sensoren/{sensorIdOrPermkey}/meetpunten

Path parameters
Parameter Type Optioneel Beschrijving

idOrPermkey

String

false

sensorIdOrPermkey

String

false
Query parameters
Parameter Type Optioneel Beschrijving

validation

Boolean

true

Default waarde: 'false'.

file

Object

false
Voorbeeld request
POST /base/instrumenten/2020-0001/sensoren/2/meetpunten HTTP/1.1
Content-Type: multipart/form-data; boundary=6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Accept: application/json
Host: services.dov.vlaanderen.be:8080

--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Content-Disposition: form-data; name=file; filename=csvfile
Content-Type: text/plain

Mock data
--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm--
Voorbeeld curl commando
$ curl 'https://services.dov.vlaanderen.be/hfmetingen/instrumenten/2020-0001/sensoren/2/meetpunten' -i -X POST \
    -H 'Content-Type: multipart/form-data' \
    -H 'Accept: application/json' \
    -F 'file=@csvfile;type=text/plain'
Voorbeeld request body
POST /base/instrumenten/2020-0001/sensoren/2/meetpunten HTTP/1.1
Content-Type: multipart/form-data; boundary=6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Accept: application/json
Host: services.dov.vlaanderen.be:8080

--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Content-Disposition: form-data; name=file; filename=csvfile
Content-Type: text/plain

Mock data
--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm--
Voorbeeld response body: succes
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 84

{
  "status" : "ASYNC",
  "aantal" : 2,
  "foutmelding" : "",
  "importLogId" : 15
}
Beschrijving velden in de resonse body
Path Type Optioneel Beschrijving

status

String

false

Moet 1 van volgende waarden zijn [OK, VALIDATIEFOUTEN, FOUTEN, LIMIET, VERWIJDER_FOUT, ASYNC].

Status controleren

Get

GET /hfmetingen/importlog/{id}

Path parameters
Parameter Type Optioneel Beschrijving

id

Integer

false
Query parameters

Geen parameters.

Voorbeeld request
GET /base/importlog/15 HTTP/1.1
Host: services.dov.vlaanderen.be:8080
Voorbeeld curl commando
$ curl 'https://services.dov.vlaanderen.be/hfmetingen/importlog/15' -i -X GET
Voorbeeld request body

Leeg

Voorbeeld response body: succes
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 356

{
  "id" : 15,
  "sensorId" : "2021-000004",
  "uploadTime" : "11-06-2020 11:04:13",
  "auteur" : "Doe Jane",
  "bestand" : {
    "code" : "251",
    "beschrijving" : "test-metingen.csv"
  },
  "status" : "NIET_VERWERKT",
  "startVerwerking" : null,
  "eindVerwerking" : null,
  "aantalMeetpunten" : null,
  "type" : "UPLOAD_REST_CSV",
  "messages" : [ ]
}
Beschrijving velden in de resonse body
Path Type Optioneel Beschrijving

id

Integer

true

Technisch id.

bestand.code

String

false

Unieke identificatie van het element.

bestand.beschrijving

String

false

Beschrijving van het element.

status

String

true

Moet 1 van volgende waarden zijn [NIET_VERWERKT, IN_VERWERKING, VERWERKT_MET_FOUTEN, VERWERKT_ZONDER_FOUTEN, VERWERKT_MET_WARNING, GEVALIDEERD_MET_FOUTEN, GEVALIDEERD_ZONDER_FOUTEN, GEVALIDEERD_MET_WARNING].

type

String

true

Moet 1 van volgende waarden zijn [UPLOAD_GUI_CSV, UPLOAD_REST_JSON, UPLOAD_REST_CSV, DELETE_GUI, DELETE_REST].

messages[].id

Integer

true

Technisch id.

messages[].severity

String

true

Moet 1 van volgende waarden zijn [FATAL, WARNING].

Status controleren

Get

GET /hfmetingen/importlog/{id}

Path parameters
Parameter Type Optioneel Beschrijving

id

Integer

false
Query parameters

Geen parameters.

Voorbeeld request
GET /base/importlog/15 HTTP/1.1
Host: services.dov.vlaanderen.be:8080
Voorbeeld curl commando
$ curl 'https://services.dov.vlaanderen.be/hfmetingen/importlog/15' -i -X GET
Voorbeeld request body

Leeg

Voorbeeld response body: succes
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 356

{
  "id" : 15,
  "sensorId" : "2021-000004",
  "uploadTime" : "11-06-2020 11:04:13",
  "auteur" : "Doe Jane",
  "bestand" : {
    "code" : "251",
    "beschrijving" : "test-metingen.csv"
  },
  "status" : "NIET_VERWERKT",
  "startVerwerking" : null,
  "eindVerwerking" : null,
  "aantalMeetpunten" : null,
  "type" : "UPLOAD_REST_CSV",
  "messages" : [ ]
}
Beschrijving velden in de resonse body
Path Type Optioneel Beschrijving

id

Integer

true

Technisch id.

bestand.code

String

false

Unieke identificatie van het element.

bestand.beschrijving

String

false

Beschrijving van het element.

status

String

true

Moet 1 van volgende waarden zijn [NIET_VERWERKT, IN_VERWERKING, VERWERKT_MET_FOUTEN, VERWERKT_ZONDER_FOUTEN, VERWERKT_MET_WARNING, GEVALIDEERD_MET_FOUTEN, GEVALIDEERD_ZONDER_FOUTEN, GEVALIDEERD_MET_WARNING].

type

String

true

Moet 1 van volgende waarden zijn [UPLOAD_GUI_CSV, UPLOAD_REST_JSON, UPLOAD_REST_CSV, DELETE_GUI, DELETE_REST].

messages[].id

Integer

true

Technisch id.

messages[].severity

String

true

Moet 1 van volgende waarden zijn [FATAL, WARNING].

Demo 5: Verwijder sensordata

Delete

DELETE /hfmetingen/instrumenten/{idOrPermkey}/sensoren/{sensorIdOrPermkey}/meetpunten

Path parameters

Parameter Type Optioneel Beschrijving

idOrPermkey

String

false

sensorIdOrPermkey

String

false

Query parameters

Parameter Type Optioneel Beschrijving

startDatum

Object

false

eindDatum

Object

true

type

String

true

Moet 1 van volgende waarden zijn [GEVALIDEERD, NIET_GEVALIDEERD].

Voorbeeld request

DELETE /base/instrumenten/2020-0001/sensoren/1/meetpunten?startDatum=2020-06-11T03%3A00%3A00.000%2B02%3A00&eindDatum=2020-06-12T03%3A00%3A00.000%2B02%3A00&type=GEVALIDEERD&userId=testUserId HTTP/1.1
Content-Type: application/json
Accept: application/json
Host: services.dov.vlaanderen.be:8080

Voorbeeld curl commando

$ curl 'https://services.dov.vlaanderen.be/hfmetingen/instrumenten/2020-0001/sensoren/1/meetpunten?startDatum=2020-06-11T03%3A00%3A00.000%2B02%3A00&eindDatum=2020-06-12T03%3A00%3A00.000%2B02%3A00&type=GEVALIDEERD&userId=testUserId' -i -X DELETE \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json'

Voorbeeld request body

Leeg

Voorbeeld response body: succes

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 93

{
  "status" : "VERWIJDER_FOUT",
  "aantal" : 2,
  "foutmelding" : "",
  "importLogId" : 15
}

Beschrijving velden in de resonse body

Path Type Optioneel Beschrijving

status

String

false

Moet 1 van volgende waarden zijn [OK, VALIDATIEFOUTEN, FOUTEN, LIMIET, VERWIJDER_FOUT, ASYNC].

Demo 6: Krijg data aan een sensor

Get

GET /hfmetingen/instrumenten/{idOrPermkey}/sensoren/{sensorIdOrPermkey}/meetpunten

Path parameters

Parameter Type Optioneel Beschrijving

idOrPermkey

String

false

sensorIdOrPermkey

String

false

Query parameters

Parameter Type Optioneel Beschrijving

startDatum

Object

true

eindDatum

Object

true

type

String

true

Moet 1 van volgende waarden zijn [GEVALIDEERD, NIET_GEVALIDEERD].

Voorbeeld request

GET /base/instrumenten/2020-0001/sensoren/1/meetpunten?startDatum=2020-06-11T03%3A00%3A00.000%2B02%3A00&eindDatum=2020-06-12T03%3A00%3A00.000%2B02%3A00&type=GEVALIDEERD HTTP/1.1
Content-Type: application/zip
Accept: application/json
Host: services.dov.vlaanderen.be:8080

Bovenstaande request vraagt een json op. Alternatief kan een CSV of ZIP gedownload worden door de accept waarde te vervangen door:

Accept : text/csv

om een CSV bestand te downloaden

Accept : application/zip

om een ZIP-bestand te downloaden

Voorbeeld curl commando

$ curl 'https://services.dov.vlaanderen.be/hfmetingen/instrumenten/2020-0001/sensoren/1/meetpunten?startDatum=2020-06-11T03%3A00%3A00.000%2B02%3A00&eindDatum=2020-06-12T03%3A00%3A00.000%2B02%3A00&type=GEVALIDEERD' -i -X GET \
    -H 'Content-Type: application/zip' \
    -H 'Accept: application/json'

Bovenstaande request vraagt een json op. Alternatief kan een CSV of ZIP gedownload worden door de accept waarde te vervangen door:

Accept : text/csv

om een CSV bestand te downloaden

Accept : application/zip

om een ZIP-bestand te downloaden

Voorbeeld request body

Leeg

Voorbeeld response body: succes

HTTP/1.1 200 OK
Content-Type: application/json

Beschrijving velden in de resonse body

Geen response body.

Demo 7: Krijg data aan een filter of bodemlocatie (meetreeks)

Om meetreeksdata te downloaden, moet de filter-permkey of bodemlocatie-permkey en id van het id van de parameter gekend zijn.

Om de mogelijke sensortypes aan een filter of bodemlocatie te bepalen kan een GET request uitgevoerd worden

Bij een filter is het domainObjecttype = "filter", bij een bodemlocatie is het domainObjecttype = "bodemlocatie"

Onderstaande voorbeeld gaat uit van een filter-koppeling. Maar dezelfde werkwijze kan gebruikt worden voor een bodemlocatie-koppeling.

Verkrijg sensortypes aan een filter

Get

GET /hfmetingen/meetreeksen/{domainObjectType}/{objectPermkey}/sensortypes

Path parameters
Parameter Type Optioneel Beschrijving

domainObjectType

String

false

objectPermkey

String

false
Query parameters

Geen parameters.

Voorbeeld request
GET /base/meetreeksen/filter/2020-0001/sensortypes HTTP/1.1
Content-Type: application/json
Accept: application/json
Host: services.dov.vlaanderen.be:8080
Voorbeeld curl commando
$ curl 'https://services.dov.vlaanderen.be/hfmetingen/meetreeksen/filter/2020-0001/sensortypes' -i -X GET \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json'
Voorbeeld request body

Leeg

Voorbeeld response body: succes
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 240

[ {
  "parameter" : {
    "code" : "4016",
    "beschrijving" : "Hydrostatische druk"
  },
  "sensorIdentificatie" : null
}, {
  "parameter" : {
    "code" : "4017",
    "beschrijving" : "Temperatuur"
  },
  "sensorIdentificatie" : null
} ]
Beschrijving velden in de resonse body
Path Type Optioneel Beschrijving

[].parameter.code

String

false

Unieke identificatie van het element.

[].parameter.beschrijving

String

false

Beschrijving van het element.

[].sensorIdentificatie.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

[].sensorIdentificatie.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

[].sensorIdentificatie.instrumentType.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

[].sensorIdentificatie.instrumentType.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

Verkrijg data

Get

GET /hfmetingen/meetreeksen/{domainObjectType}/{objectPermkey}/parameters/{parameterId}/meetpunten

Path parameters
Parameter Type Optioneel Beschrijving

domainObjectType

String

false

objectPermkey

String

false

parameterId

String

false

sensorIdentificatieCode

String

true
Query parameters
Parameter Type Optioneel Beschrijving

startDatum

Object

true

eindDatum

Object

true

type

String

true

Moet 1 van volgende waarden zijn [GEVALIDEERD, NIET_GEVALIDEERD].
Voorbeeld request
GET /base/meetreeksen/filter/2020-0001/parameters/4016/meetpunten?startDatum=2020-06-11T03%3A00%3A00.000%2B02%3A00&eindDatum=2020-06-12T03%3A00%3A00.000%2B02%3A00&type=GEVALIDEERD HTTP/1.1
Content-Type: application/zip
Accept: application/json
Host: services.dov.vlaanderen.be:8080

Bovenstaande request vraagt een json op. Alternatief kan een CSV of ZIP gedownload worden door de accept waarde te vervangen door:

Accept : text/csv

om een CSV bestand te downloaden

Accept : application/zip

om een ZIP-bestand te downloaden

Voorbeeld curl commando
$ curl 'https://services.dov.vlaanderen.be/hfmetingen/meetreeksen/filter/2020-0001/parameters/4016/meetpunten?startDatum=2020-06-11T03%3A00%3A00.000%2B02%3A00&eindDatum=2020-06-12T03%3A00%3A00.000%2B02%3A00&type=GEVALIDEERD' -i -X GET \
    -H 'Content-Type: application/zip' \
    -H 'Accept: application/json'

Bovenstaande request vraagt een json op. Alternatief kan een CSV of ZIP gedownload worden door de accept waarde te vervangen door:

Accept : text/csv

om een CSV bestand te downloaden

Accept : application/zip

om een ZIP-bestand te downloaden

Voorbeeld request body

Leeg

Voorbeeld response body: succes
HTTP/1.1 200 OK
Content-Type: application/json
Beschrijving velden in de resonse body

Geen response body.

Demo 8: Aanmaken en updaten van een instrument

Algemene aandachtspunten

Bij het aanmaken of updaten van een instrument kunnen verschillende velden een codelijst bevatten. Hier is het verplicht steeds een code mee te geven tenzij hieronder anders vermeld.

  • Parameters kunnen geïdentificeerd worden aan de hand van hun id of korte naam. 1 van beide moet maar meegegeven worden. Id heeft hier prioriteit.

  • Meeteenheden kunnen geïdentificeerd worden aan de hand van hun code of afkorting. 1 van beide moet maar meegegeven worden. Code heeft hier prioriteit.

  • Databeheerders kunnen geïdentificeerd worden aan de hand van hun id of kbonummer. 1 van beide moet maar meegegeven worden. Id heeft hier prioriteit. Opmerking: Id of kbonummer dient ingegeven te worden als id veld, met de andere databeheerder velden wordt geen rekening gehouden in de request.

Aanmaken

Een instrument kan aangemaakt worden door een POST request te doen naar de server met in de body een json die de data bevat om een instrument aan te maken.

Hier mogen geen id’s of permkey’s meegegeven worden. Indien er meegegeven worden zullen er validatiefouten terug gestuurd worden.

POST /hfmetingen/instrumenten

Path parameters

Geen parameters.

Query parameters

Geen parameters.

Voorbeeld minimale json
{
   "metadata":{
      "naam":"JSY Test 002",
      "type":{
         "code":"TMS-NB"
      },
      "serienummer":"SEJSY02",
      "datumInGebruik":"2022-08-01"
   },
   "objectBeheer":{
      "status":{
         "code":"4"
      },
      "databeheerder":{
         "id":"10"
      }
   },
   "sensorData":{
      "sensoren":[
         {
            "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"
            }
         },
         {
            "naam":"V1",
            "parameter":{
               "id":"1912"
            },
            "sensorIdentificatie":{
               "code":"CN_SWC"
            },
            "meeteenheid":{
               "code":"127"
            }
         }
      ]
   }
}
Voorbeeld request algemeen
POST /base/instrumenten/ HTTP/1.1
Content-Type: application/json
Accept: application/json
Content-Length: 7023
Host: services.dov.vlaanderen.be:8080

{
  "id" : null,
  "permKey" : null,
  "metadata" : {
    "id" : null,
    "naam" : "IMPORT_JSY_1",
    "type" : {
      "code" : "TMS-NB",
      "beschrijving" : null
    },
    "serienummer" : "IMP_1_DOLK",
    "referentie" : "Import curieuzeneuze dolk",
    "datumInGebruik" : "2021-03-01T00:00:00.000+00:00",
    "datumUitGebruik" : null,
    "typeNummer" : {
      "code" : "CN_ONB",
      "beschrijving" : null,
      "merk" : null,
      "instrumentType" : null
    },
    "locatieStatus" : null,
    "batterijLaatstVervangen" : null,
    "transmissie" : null
  },
  "objectBeheer" : {
    "id" : null,
    "status" : {
      "code" : "4",
      "beschrijving" : "Publiek"
    },
    "databeheerder" : {
      "id" : "8",
      "kbonummer" : null,
      "ovocode" : null,
      "naam" : "VMM"
    },
    "leesgroepen" : null
  },
  "sensorData" : {
    "instrument" : null,
    "sensoren" : [ {
      "id" : null,
      "permKey" : null,
      "naam" : "SWC",
      "instrument" : null,
      "parameter" : {
        "id" : "CN_SWC",
        "korteNaam" : null,
        "beschrijving" : null,
        "betekenis" : null,
        "volgnummer" : null,
        "parametergroep" : null,
        "meeteenheid" : null,
        "bovengrens" : null,
        "ondergrens" : null,
        "displayformat" : null,
        "casRegistryNumber" : null,
        "ecNumber" : null,
        "valueType" : null,
        "fixed" : false,
        "analysemethodes" : [ ],
        "standaardgroepen" : [ ],
        "meeteenheden" : [ ],
        "keuzeLijst" : null,
        "meetpuntParameter" : null,
        "meetwaardeParameter" : null,
        "primair" : false,
        "secundair" : false
      },
      "sensorIdentificatie" : {
        "code" : "CN_SWC",
        "beschrijving" : null,
        "instrumentType" : null
      },
      "meeteenheid" : {
        "code" : "127",
        "beschrijving" : null,
        "afkorting" : null
      },
      "aantalDataPunten" : null,
      "eersteData" : null,
      "laatsteData" : null,
      "laatsteImportLog" : null,
      "nauwkeurigheid" : null,
      "precisie" : null,
      "meetbereikVan" : null,
      "meetbereikTot" : null,
      "businessKey" : "SWC"
    }, {
      "id" : null,
      "permKey" : null,
      "naam" : "T1",
      "instrument" : null,
      "parameter" : {
        "id" : "4017",
        "korteNaam" : null,
        "beschrijving" : null,
        "betekenis" : null,
        "volgnummer" : null,
        "parametergroep" : null,
        "meeteenheid" : null,
        "bovengrens" : null,
        "ondergrens" : null,
        "displayformat" : null,
        "casRegistryNumber" : null,
        "ecNumber" : null,
        "valueType" : null,
        "fixed" : false,
        "analysemethodes" : [ ],
        "standaardgroepen" : [ ],
        "meeteenheden" : [ ],
        "keuzeLijst" : null,
        "meetpuntParameter" : null,
        "meetwaardeParameter" : null,
        "primair" : false,
        "secundair" : false
      },
      "sensorIdentificatie" : {
        "code" : "CN_T1",
        "beschrijving" : null,
        "instrumentType" : null
      },
      "meeteenheid" : {
        "code" : "3",
        "beschrijving" : null,
        "afkorting" : null
      },
      "aantalDataPunten" : null,
      "eersteData" : null,
      "laatsteData" : null,
      "laatsteImportLog" : null,
      "nauwkeurigheid" : null,
      "precisie" : null,
      "meetbereikVan" : null,
      "meetbereikTot" : null,
      "businessKey" : "T1"
    }, {
      "id" : null,
      "permKey" : null,
      "naam" : "T2",
      "instrument" : null,
      "parameter" : {
        "id" : "4017",
        "korteNaam" : null,
        "beschrijving" : null,
        "betekenis" : null,
        "volgnummer" : null,
        "parametergroep" : null,
        "meeteenheid" : null,
        "bovengrens" : null,
        "ondergrens" : null,
        "displayformat" : null,
        "casRegistryNumber" : null,
        "ecNumber" : null,
        "valueType" : null,
        "fixed" : false,
        "analysemethodes" : [ ],
        "standaardgroepen" : [ ],
        "meeteenheden" : [ ],
        "keuzeLijst" : null,
        "meetpuntParameter" : null,
        "meetwaardeParameter" : null,
        "primair" : false,
        "secundair" : false
      },
      "sensorIdentificatie" : {
        "code" : "CN_T2",
        "beschrijving" : null,
        "instrumentType" : null
      },
      "meeteenheid" : {
        "code" : "3",
        "beschrijving" : null,
        "afkorting" : null
      },
      "aantalDataPunten" : null,
      "eersteData" : null,
      "laatsteData" : null,
      "laatsteImportLog" : null,
      "nauwkeurigheid" : null,
      "precisie" : null,
      "meetbereikVan" : null,
      "meetbereikTot" : null,
      "businessKey" : "T2"
    }, {
      "id" : null,
      "permKey" : null,
      "naam" : "T3",
      "instrument" : null,
      "parameter" : {
        "id" : "4017",
        "korteNaam" : null,
        "beschrijving" : null,
        "betekenis" : null,
        "volgnummer" : null,
        "parametergroep" : null,
        "meeteenheid" : null,
        "bovengrens" : null,
        "ondergrens" : null,
        "displayformat" : null,
        "casRegistryNumber" : null,
        "ecNumber" : null,
        "valueType" : null,
        "fixed" : false,
        "analysemethodes" : [ ],
        "standaardgroepen" : [ ],
        "meeteenheden" : [ ],
        "keuzeLijst" : null,
        "meetpuntParameter" : null,
        "meetwaardeParameter" : null,
        "primair" : false,
        "secundair" : false
      },
      "sensorIdentificatie" : {
        "code" : "CN_T3",
        "beschrijving" : null,
        "instrumentType" : null
      },
      "meeteenheid" : {
        "code" : "3",
        "beschrijving" : null,
        "afkorting" : null
      },
      "aantalDataPunten" : null,
      "eersteData" : null,
      "laatsteData" : null,
      "laatsteImportLog" : null,
      "nauwkeurigheid" : null,
      "precisie" : null,
      "meetbereikVan" : null,
      "meetbereikTot" : null,
      "businessKey" : "T3"
    } ],
    "id" : null
  },
  "compensatieData" : {
    "instrument" : null,
    "compensaties" : [ {
      "id" : null,
      "sensor" : {
        "id" : null,
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : "T1",
        "objectBeheer" : null
      },
      "instrument" : null,
      "van" : "01-05-2021 00:00:00",
      "tot" : null,
      "compensatie" : {
        "code" : "CAP",
        "beschrijving" : null
      },
      "businessKey" : "T1"
    }, {
      "id" : null,
      "sensor" : {
        "id" : null,
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : "T3",
        "objectBeheer" : null
      },
      "instrument" : null,
      "van" : "02-05-2021 00:00:00",
      "tot" : "04-05-2021 00:00:00",
      "compensatie" : {
        "code" : "NT",
        "beschrijving" : null
      },
      "businessKey" : "T3"
    } ],
    "id" : null
  }
}
Voorbeeld request body
POST /base/instrumenten/ HTTP/1.1
Content-Type: application/json
Accept: application/json
Content-Length: 7023
Host: services.dov.vlaanderen.be:8080

{
  "id" : null,
  "permKey" : null,
  "metadata" : {
    "id" : null,
    "naam" : "IMPORT_JSY_1",
    "type" : {
      "code" : "TMS-NB",
      "beschrijving" : null
    },
    "serienummer" : "IMP_1_DOLK",
    "referentie" : "Import curieuzeneuze dolk",
    "datumInGebruik" : "2021-03-01T00:00:00.000+00:00",
    "datumUitGebruik" : null,
    "typeNummer" : {
      "code" : "CN_ONB",
      "beschrijving" : null,
      "merk" : null,
      "instrumentType" : null
    },
    "locatieStatus" : null,
    "batterijLaatstVervangen" : null,
    "transmissie" : null
  },
  "objectBeheer" : {
    "id" : null,
    "status" : {
      "code" : "4",
      "beschrijving" : "Publiek"
    },
    "databeheerder" : {
      "id" : "8",
      "kbonummer" : null,
      "ovocode" : null,
      "naam" : "VMM"
    },
    "leesgroepen" : null
  },
  "sensorData" : {
    "instrument" : null,
    "sensoren" : [ {
      "id" : null,
      "permKey" : null,
      "naam" : "SWC",
      "instrument" : null,
      "parameter" : {
        "id" : "CN_SWC",
        "korteNaam" : null,
        "beschrijving" : null,
        "betekenis" : null,
        "volgnummer" : null,
        "parametergroep" : null,
        "meeteenheid" : null,
        "bovengrens" : null,
        "ondergrens" : null,
        "displayformat" : null,
        "casRegistryNumber" : null,
        "ecNumber" : null,
        "valueType" : null,
        "fixed" : false,
        "analysemethodes" : [ ],
        "standaardgroepen" : [ ],
        "meeteenheden" : [ ],
        "keuzeLijst" : null,
        "meetpuntParameter" : null,
        "meetwaardeParameter" : null,
        "primair" : false,
        "secundair" : false
      },
      "sensorIdentificatie" : {
        "code" : "CN_SWC",
        "beschrijving" : null,
        "instrumentType" : null
      },
      "meeteenheid" : {
        "code" : "127",
        "beschrijving" : null,
        "afkorting" : null
      },
      "aantalDataPunten" : null,
      "eersteData" : null,
      "laatsteData" : null,
      "laatsteImportLog" : null,
      "nauwkeurigheid" : null,
      "precisie" : null,
      "meetbereikVan" : null,
      "meetbereikTot" : null,
      "businessKey" : "SWC"
    }, {
      "id" : null,
      "permKey" : null,
      "naam" : "T1",
      "instrument" : null,
      "parameter" : {
        "id" : "4017",
        "korteNaam" : null,
        "beschrijving" : null,
        "betekenis" : null,
        "volgnummer" : null,
        "parametergroep" : null,
        "meeteenheid" : null,
        "bovengrens" : null,
        "ondergrens" : null,
        "displayformat" : null,
        "casRegistryNumber" : null,
        "ecNumber" : null,
        "valueType" : null,
        "fixed" : false,
        "analysemethodes" : [ ],
        "standaardgroepen" : [ ],
        "meeteenheden" : [ ],
        "keuzeLijst" : null,
        "meetpuntParameter" : null,
        "meetwaardeParameter" : null,
        "primair" : false,
        "secundair" : false
      },
      "sensorIdentificatie" : {
        "code" : "CN_T1",
        "beschrijving" : null,
        "instrumentType" : null
      },
      "meeteenheid" : {
        "code" : "3",
        "beschrijving" : null,
        "afkorting" : null
      },
      "aantalDataPunten" : null,
      "eersteData" : null,
      "laatsteData" : null,
      "laatsteImportLog" : null,
      "nauwkeurigheid" : null,
      "precisie" : null,
      "meetbereikVan" : null,
      "meetbereikTot" : null,
      "businessKey" : "T1"
    }, {
      "id" : null,
      "permKey" : null,
      "naam" : "T2",
      "instrument" : null,
      "parameter" : {
        "id" : "4017",
        "korteNaam" : null,
        "beschrijving" : null,
        "betekenis" : null,
        "volgnummer" : null,
        "parametergroep" : null,
        "meeteenheid" : null,
        "bovengrens" : null,
        "ondergrens" : null,
        "displayformat" : null,
        "casRegistryNumber" : null,
        "ecNumber" : null,
        "valueType" : null,
        "fixed" : false,
        "analysemethodes" : [ ],
        "standaardgroepen" : [ ],
        "meeteenheden" : [ ],
        "keuzeLijst" : null,
        "meetpuntParameter" : null,
        "meetwaardeParameter" : null,
        "primair" : false,
        "secundair" : false
      },
      "sensorIdentificatie" : {
        "code" : "CN_T2",
        "beschrijving" : null,
        "instrumentType" : null
      },
      "meeteenheid" : {
        "code" : "3",
        "beschrijving" : null,
        "afkorting" : null
      },
      "aantalDataPunten" : null,
      "eersteData" : null,
      "laatsteData" : null,
      "laatsteImportLog" : null,
      "nauwkeurigheid" : null,
      "precisie" : null,
      "meetbereikVan" : null,
      "meetbereikTot" : null,
      "businessKey" : "T2"
    }, {
      "id" : null,
      "permKey" : null,
      "naam" : "T3",
      "instrument" : null,
      "parameter" : {
        "id" : "4017",
        "korteNaam" : null,
        "beschrijving" : null,
        "betekenis" : null,
        "volgnummer" : null,
        "parametergroep" : null,
        "meeteenheid" : null,
        "bovengrens" : null,
        "ondergrens" : null,
        "displayformat" : null,
        "casRegistryNumber" : null,
        "ecNumber" : null,
        "valueType" : null,
        "fixed" : false,
        "analysemethodes" : [ ],
        "standaardgroepen" : [ ],
        "meeteenheden" : [ ],
        "keuzeLijst" : null,
        "meetpuntParameter" : null,
        "meetwaardeParameter" : null,
        "primair" : false,
        "secundair" : false
      },
      "sensorIdentificatie" : {
        "code" : "CN_T3",
        "beschrijving" : null,
        "instrumentType" : null
      },
      "meeteenheid" : {
        "code" : "3",
        "beschrijving" : null,
        "afkorting" : null
      },
      "aantalDataPunten" : null,
      "eersteData" : null,
      "laatsteData" : null,
      "laatsteImportLog" : null,
      "nauwkeurigheid" : null,
      "precisie" : null,
      "meetbereikVan" : null,
      "meetbereikTot" : null,
      "businessKey" : "T3"
    } ],
    "id" : null
  },
  "compensatieData" : {
    "instrument" : null,
    "compensaties" : [ {
      "id" : null,
      "sensor" : {
        "id" : null,
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : "T1",
        "objectBeheer" : null
      },
      "instrument" : null,
      "van" : "01-05-2021 00:00:00",
      "tot" : null,
      "compensatie" : {
        "code" : "CAP",
        "beschrijving" : null
      },
      "businessKey" : "T1"
    }, {
      "id" : null,
      "sensor" : {
        "id" : null,
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : "T3",
        "objectBeheer" : null
      },
      "instrument" : null,
      "van" : "02-05-2021 00:00:00",
      "tot" : "04-05-2021 00:00:00",
      "compensatie" : {
        "code" : "NT",
        "beschrijving" : null
      },
      "businessKey" : "T3"
    } ],
    "id" : null
  }
}
Voorbeeld response body: succes
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 10226

{
  "id" : 97,
  "permKey" : "2021-000092",
  "metadata" : {
    "id" : 97,
    "naam" : "IMPORT_JSY_1",
    "type" : {
      "code" : "TMS-NB",
      "beschrijving" : "Temperature Moisture Sensor - NarrowBand"
    },
    "serienummer" : "IMP_1_DOLK",
    "referentie" : "Import curieuzeneuze dolk",
    "datumInGebruik" : "2021-03-01T00:00:00.000+00:00",
    "datumUitGebruik" : null,
    "typeNummer" : {
      "code" : "CN_ONB",
      "beschrijving" : "Curieuzeneuze Onbekend",
      "merk" : {
        "code" : "CN_DLK",
        "beschrijving" : "GazonDolk",
        "fabrikant" : {
          "code" : "CN",
          "beschrijving" : "Curieuzeneuze"
        }
      },
      "instrumentType" : null
    },
    "locatieStatus" : null,
    "batterijLaatstVervangen" : null,
    "transmissie" : null
  },
  "objectBeheer" : {
    "id" : 98,
    "status" : {
      "code" : "4",
      "beschrijving" : "Publiek"
    },
    "databeheerder" : {
      "id" : "8",
      "kbonummer" : null,
      "ovocode" : null,
      "naam" : "VMM"
    },
    "leesgroepen" : null
  },
  "sensorData" : {
    "instrument" : {
      "id" : "97",
      "permKey" : "2021-000092",
      "domainObjectType" : null,
      "naam" : "IMPORT_JSY_1",
      "objectBeheer" : {
        "id" : 98,
        "status" : {
          "code" : "4",
          "beschrijving" : "Publiek"
        },
        "databeheerder" : {
          "id" : "8",
          "kbonummer" : null,
          "ovocode" : null,
          "naam" : "VMM"
        },
        "leesgroepen" : null
      }
    },
    "sensoren" : [ {
      "id" : 112,
      "permKey" : "2021-000084",
      "naam" : "SWC1",
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "parameter" : {
        "id" : "CN_SWC",
        "korteNaam" : null,
        "beschrijving" : null,
        "betekenis" : null,
        "volgnummer" : null,
        "parametergroep" : null,
        "meeteenheid" : null,
        "bovengrens" : null,
        "ondergrens" : null,
        "displayformat" : null,
        "casRegistryNumber" : null,
        "ecNumber" : null,
        "valueType" : null,
        "fixed" : false,
        "analysemethodes" : [ ],
        "standaardgroepen" : [ ],
        "meeteenheden" : [ ],
        "keuzeLijst" : null,
        "meetpuntParameter" : null,
        "meetwaardeParameter" : null,
        "primair" : false,
        "secundair" : false
      },
      "sensorIdentificatie" : {
        "code" : "CN_SWC",
        "beschrijving" : "Curieuzeneuzen volumetrisch vochtgehalte X",
        "instrumentType" : {
          "code" : "TMS-NB",
          "beschrijving" : "Temperature Moisture Sensor - NarrowBand"
        }
      },
      "meeteenheid" : {
        "code" : "127",
        "beschrijving" : null,
        "afkorting" : null
      },
      "aantalDataPunten" : 0,
      "eersteData" : null,
      "laatsteData" : null,
      "laatsteImportLog" : null,
      "nauwkeurigheid" : null,
      "precisie" : null,
      "meetbereikVan" : null,
      "meetbereikTot" : null,
      "businessKey" : "SWC1"
    }, {
      "id" : 113,
      "permKey" : "2021-000085",
      "naam" : "T1",
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "parameter" : {
        "id" : "4017",
        "korteNaam" : null,
        "beschrijving" : null,
        "betekenis" : null,
        "volgnummer" : null,
        "parametergroep" : null,
        "meeteenheid" : null,
        "bovengrens" : null,
        "ondergrens" : null,
        "displayformat" : null,
        "casRegistryNumber" : null,
        "ecNumber" : null,
        "valueType" : null,
        "fixed" : false,
        "analysemethodes" : [ ],
        "standaardgroepen" : [ ],
        "meeteenheden" : [ ],
        "keuzeLijst" : null,
        "meetpuntParameter" : null,
        "meetwaardeParameter" : null,
        "primair" : false,
        "secundair" : false
      },
      "sensorIdentificatie" : {
        "code" : "CN_T1",
        "beschrijving" : "Curieuzeneuzen temperatuur boven maaiveld",
        "instrumentType" : {
          "code" : "TMS-NB",
          "beschrijving" : "Temperature Moisture Sensor - NarrowBand"
        }
      },
      "meeteenheid" : {
        "code" : "3",
        "beschrijving" : null,
        "afkorting" : null
      },
      "aantalDataPunten" : 0,
      "eersteData" : null,
      "laatsteData" : null,
      "laatsteImportLog" : null,
      "nauwkeurigheid" : null,
      "precisie" : null,
      "meetbereikVan" : null,
      "meetbereikTot" : null,
      "businessKey" : "T1"
    }, {
      "id" : 114,
      "permKey" : "2021-000086",
      "naam" : "T2",
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "parameter" : {
        "id" : "4017",
        "korteNaam" : null,
        "beschrijving" : null,
        "betekenis" : null,
        "volgnummer" : null,
        "parametergroep" : null,
        "meeteenheid" : null,
        "bovengrens" : null,
        "ondergrens" : null,
        "displayformat" : null,
        "casRegistryNumber" : null,
        "ecNumber" : null,
        "valueType" : null,
        "fixed" : false,
        "analysemethodes" : [ ],
        "standaardgroepen" : [ ],
        "meeteenheden" : [ ],
        "keuzeLijst" : null,
        "meetpuntParameter" : null,
        "meetwaardeParameter" : null,
        "primair" : false,
        "secundair" : false
      },
      "sensorIdentificatie" : {
        "code" : "CN_T2",
        "beschrijving" : "Curieuzeneuzen temperatuur op maaiveld",
        "instrumentType" : {
          "code" : "TMS-NB",
          "beschrijving" : "Temperature Moisture Sensor - NarrowBand"
        }
      },
      "meeteenheid" : {
        "code" : "3",
        "beschrijving" : null,
        "afkorting" : null
      },
      "aantalDataPunten" : 0,
      "eersteData" : null,
      "laatsteData" : null,
      "laatsteImportLog" : null,
      "nauwkeurigheid" : null,
      "precisie" : null,
      "meetbereikVan" : null,
      "meetbereikTot" : null,
      "businessKey" : "T2"
    } ],
    "id" : 97
  },
  "compensatieData" : {
    "instrument" : {
      "id" : "97",
      "permKey" : "2021-000092",
      "domainObjectType" : null,
      "naam" : "IMPORT_JSY_1",
      "objectBeheer" : {
        "id" : 98,
        "status" : {
          "code" : "4",
          "beschrijving" : "Publiek"
        },
        "databeheerder" : {
          "id" : "8",
          "kbonummer" : null,
          "ovocode" : null,
          "naam" : "VMM"
        },
        "leesgroepen" : null
      }
    },
    "compensaties" : [ {
      "id" : 41,
      "sensor" : {
        "id" : "113",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : "T1",
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "van" : "01-05-2021 00:00:00",
      "tot" : null,
      "compensatie" : {
        "code" : "CAP",
        "beschrijving" : "Gecompenseerd via capillair"
      },
      "businessKey" : "T1"
    }, {
      "id" : 42,
      "sensor" : {
        "id" : "115",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : "T3",
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "van" : "02-05-2021 00:00:00",
      "tot" : "04-05-2021 00:00:00",
      "compensatie" : {
        "code" : "NT",
        "beschrijving" : "Niet gecompenseerd"
      },
      "businessKey" : "T3"
    } ],
    "id" : 97
  }
}
Beschrijving velden in de resonse body
Path Type Optioneel Beschrijving

id

Integer

true

Technisch id.

permKey

String

true

Permanente identifier.

metadata.id

Integer

true

Technisch id.

metadata.naam

String

true

Het veld mag niet leeg zijn.
Size must be between 0 and 100 inclusive.

metadata.type.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

metadata.type.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

metadata.serienummer

String

true

Het veld mag niet leeg zijn.
Size must be between 0 and 50 inclusive.

metadata.referentie

String

true

Size must be between 0 and 50 inclusive.

metadata.typeNummer.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 50 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

metadata.typeNummer.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 100 karakters zijn.

metadata.typeNummer.merk.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 50 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

metadata.typeNummer.merk.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 100 karakters zijn.

metadata.typeNummer.merk.fabrikant.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 50 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

metadata.typeNummer.merk.fabrikant.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

metadata.typeNummer.instrumentType.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

metadata.typeNummer.instrumentType.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

metadata.locatieStatus.code

String

false

Unieke identificatie van het element.

metadata.locatieStatus.beschrijving

String

false

Beschrijving van het element.

metadata.transmissie.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

metadata.transmissie.beschrijving

String

false

Beschrijving van het element.

objectBeheer.id

Integer

true

Technisch id.

objectBeheer.status.code

String

false

Unieke identificatie van het element.

Veld mag geen spaties bevatten.
code moet 1 tot 10 karakters zijn.

objectBeheer.status.beschrijving

String

false

Beschrijving van het element.

beschrijving moet 1 tot 50 karakters zijn.

objectBeheer.databeheerder.id

String

true

Technisch id.

objectBeheer.leesgroepen.id

String

true

Technisch id.

objectBeheer.leesgroepen.leden[].id

String

true

Technisch id.

sensorData.instrument.id

String

true

Technisch id.

sensorData.instrument.permKey

String

true

Permanente identifier.

sensorData.instrument.domainObjectType

String

true

Moet 1 van volgende waarden zijn [BORING, DOSSIER, OPDRACHT, INTERPRETATIE, SONDERING, XML, PUT, TYPEPUT, GWLOCATIE, FILTER, FILTERGROEP, TYPEFILTER, WATERMONSTER, GRONDMONSTER, MONSTER, PERCEELANALYSE, BODEMSITE, BODEMLOCATIE, EXPLOITANT, IIOA, IIOA_BESLISSING, INSTALLATIE, VERGUNNING, VERGUNNING_PROCEDURE, VERGUNNING_MASTER, BODEMCLASSIFICATIE_BE, BODEMCLASSIFICATIE_WRB, BODEMCLASSIFICATIE_EXTRA, BODEMKUNDIGEOPBOUW, BODEMDIEPTEINTERVAL, BODEMMONSTER, BODEMOBSERVATIE, BODEMOBSERVATIEPLAN, VOORAFMELDING, NULMELDING, BEMALING, INSTRUMENT, SENSOR, TERREINVINPROEF, GEOLABOPROEVEN, VOLUMEMASSA, WATERGEHALTE, SAMENDRUKKING, LABOVIN, TRIAXIAAL, GEOCORE, BOORMEESTEROPLEIDING, BOORBEDRIJF, OBSERVATIE, UNKNOWN].

sensorData.instrument.objectBeheer.id

Integer

true

Technisch id.

sensorData.instrument.objectBeheer.status.code

String

false

Unieke identificatie van het element.

Veld mag geen spaties bevatten.
code moet 1 tot 10 karakters zijn.

sensorData.instrument.objectBeheer.status.beschrijving

String

false

Beschrijving van het element.

beschrijving moet 1 tot 50 karakters zijn.

sensorData.instrument.objectBeheer.databeheerder.id

String

true

Technisch id.

sensorData.instrument.objectBeheer.leesgroepen.id

String

true

Technisch id.

sensorData.instrument.objectBeheer.leesgroepen.leden[].id

String

true

Technisch id.

sensorData.sensoren[].id

Integer

true

Technisch id.

sensorData.sensoren[].permKey

String

true

Permanente identifier.

sensorData.sensoren[].naam

String

false

Het veld mag niet leeg zijn.
Size must be between 0 and 100 inclusive.

sensorData.sensoren[].instrument.id

String

true

Technisch id.

sensorData.sensoren[].instrument.permKey

String

true

Permanente identifier.

sensorData.sensoren[].instrument.domainObjectType

String

true

Moet 1 van volgende waarden zijn [BORING, DOSSIER, OPDRACHT, INTERPRETATIE, SONDERING, XML, PUT, TYPEPUT, GWLOCATIE, FILTER, FILTERGROEP, TYPEFILTER, WATERMONSTER, GRONDMONSTER, MONSTER, PERCEELANALYSE, BODEMSITE, BODEMLOCATIE, EXPLOITANT, IIOA, IIOA_BESLISSING, INSTALLATIE, VERGUNNING, VERGUNNING_PROCEDURE, VERGUNNING_MASTER, BODEMCLASSIFICATIE_BE, BODEMCLASSIFICATIE_WRB, BODEMCLASSIFICATIE_EXTRA, BODEMKUNDIGEOPBOUW, BODEMDIEPTEINTERVAL, BODEMMONSTER, BODEMOBSERVATIE, BODEMOBSERVATIEPLAN, VOORAFMELDING, NULMELDING, BEMALING, INSTRUMENT, SENSOR, TERREINVINPROEF, GEOLABOPROEVEN, VOLUMEMASSA, WATERGEHALTE, SAMENDRUKKING, LABOVIN, TRIAXIAAL, GEOCORE, BOORMEESTEROPLEIDING, BOORBEDRIJF, OBSERVATIE, UNKNOWN].

sensorData.sensoren[].instrument.objectBeheer.id

Integer

true

Technisch id.

sensorData.sensoren[].instrument.objectBeheer.status.code

String

false

Unieke identificatie van het element.

Veld mag geen spaties bevatten.
code moet 1 tot 10 karakters zijn.

sensorData.sensoren[].instrument.objectBeheer.status.beschrijving

String

false

Beschrijving van het element.

beschrijving moet 1 tot 50 karakters zijn.

sensorData.sensoren[].instrument.objectBeheer.databeheerder.id

String

true

Technisch id.

sensorData.sensoren[].instrument.objectBeheer.leesgroepen.id

String

true

Technisch id.

sensorData.sensoren[].instrument.objectBeheer.leesgroepen.leden[].id

String

true

Technisch id.

sensorData.sensoren[].parameter.id

String

true

Technisch id.

sensorData.sensoren[].parameter.korteNaam

String

false

Korte naam moet 1 tot 50 karakters zijn.

sensorData.sensoren[].parameter.beschrijving

String

false

Beschrijving van het element.

Bechrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].parameter.parametergroep.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Veld mag geen spaties bevatten.

sensorData.sensoren[].parameter.parametergroep.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 100 karakters zijn.

sensorData.sensoren[].parameter.parametergroep.groepType

String

true

Moet 1 van volgende waarden zijn [W, G, B].

sensorData.sensoren[].parameter.meeteenheid.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Veld mag geen spaties bevatten.

sensorData.sensoren[].parameter.meeteenheid.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].parameter.meeteenheid.afkorting

String

false

Afkorting moet 1 tot 25 karakters zijn.

sensorData.sensoren[].parameter.displayformat

String

true

Weergave mag maximum 20 karakters zijn.

sensorData.sensoren[].parameter.casRegistryNumber

String

true

CAS nummer mag maximum 12 karakters zijn.

sensorData.sensoren[].parameter.ecNumber

String

true

EG-nummer mag maximum 9 karakters zijn.

sensorData.sensoren[].parameter.valueType

String

true

Moet 1 van volgende waarden zijn [NUM, TXT, BLANCO, REF, TM, MR, TMR].

sensorData.sensoren[].parameter.analysemethodes[].code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Veld mag geen spaties bevatten.

sensorData.sensoren[].parameter.analysemethodes[].beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].parameter.analysemethodes[].secundaireParameters[].id

String

true

Technisch id.

sensorData.sensoren[].parameter.standaardgroepen[].code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Veld mag geen spaties bevatten.

sensorData.sensoren[].parameter.standaardgroepen[].beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].parameter.meeteenheden[].id

String

true

Technisch id.

sensorData.sensoren[].parameter.meeteenheden[].meetEenheid.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Veld mag geen spaties bevatten.

sensorData.sensoren[].parameter.meeteenheden[].meetEenheid.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].parameter.meeteenheden[].meetEenheid.afkorting

String

false

Afkorting moet 1 tot 25 karakters zijn.

sensorData.sensoren[].parameter.meeteenheden[].omrekeningsformule

String

true

Moet 1 van volgende waarden zijn [LIN].

sensorData.sensoren[].parameter.meeteenheden[].displayformatNaam

String

true

Weergave mag maximum 10 karakters zijn.

sensorData.sensoren[].parameter.keuzeLijst[].code

String

true

Unieke identificatie van het element.

sensorData.sensoren[].parameter.keuzeLijst[].beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].sensorIdentificatie.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

sensorData.sensoren[].sensorIdentificatie.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].sensorIdentificatie.instrumentType.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

sensorData.sensoren[].sensorIdentificatie.instrumentType.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].meeteenheid.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Veld mag geen spaties bevatten.

sensorData.sensoren[].meeteenheid.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].meeteenheid.afkorting

String

false

Afkorting moet 1 tot 25 karakters zijn.

sensorData.sensoren[].laatsteImportLog.id

Integer

true

Technisch id.

sensorData.sensoren[].laatsteImportLog.bestand.code

String

false

Unieke identificatie van het element.

sensorData.sensoren[].laatsteImportLog.bestand.beschrijving

String

false

Beschrijving van het element.

sensorData.sensoren[].laatsteImportLog.status

String

true

Moet 1 van volgende waarden zijn [NIET_VERWERKT, IN_VERWERKING, VERWERKT_MET_FOUTEN, VERWERKT_ZONDER_FOUTEN, VERWERKT_MET_WARNING, GEVALIDEERD_MET_FOUTEN, GEVALIDEERD_ZONDER_FOUTEN, GEVALIDEERD_MET_WARNING].

sensorData.sensoren[].laatsteImportLog.type

String

true

Moet 1 van volgende waarden zijn [UPLOAD_GUI_CSV, UPLOAD_REST_JSON, UPLOAD_REST_CSV, DELETE_GUI, DELETE_REST].

sensorData.sensoren[].laatsteImportLog.messages[].id

Integer

true

Technisch id.

sensorData.sensoren[].laatsteImportLog.messages[].severity

String

true

Moet 1 van volgende waarden zijn [FATAL, WARNING].

sensorData.sensoren[].nauwkeurigheid

Decimal

true

Must be at least 0.
Must be at most 100.
Must have at most 3 integral digits and 2 fractional digits.

sensorData.sensoren[].precisie

Decimal

true

Must be at least 0.
Must have at most 7 integral digits and 8 fractional digits.

sensorData.sensoren[].meetbereikVan

Decimal

true

Must have at most 7 integral digits and 8 fractional digits.

sensorData.sensoren[].meetbereikTot

Decimal

true

Must have at most 7 integral digits and 8 fractional digits.

sensorData.id

Integer

true

Technisch id.

compensatieData.instrument.id

String

true

Technisch id.

compensatieData.instrument.permKey

String

true

Permanente identifier.

compensatieData.instrument.domainObjectType

String

true

Moet 1 van volgende waarden zijn [BORING, DOSSIER, OPDRACHT, INTERPRETATIE, SONDERING, XML, PUT, TYPEPUT, GWLOCATIE, FILTER, FILTERGROEP, TYPEFILTER, WATERMONSTER, GRONDMONSTER, MONSTER, PERCEELANALYSE, BODEMSITE, BODEMLOCATIE, EXPLOITANT, IIOA, IIOA_BESLISSING, INSTALLATIE, VERGUNNING, VERGUNNING_PROCEDURE, VERGUNNING_MASTER, BODEMCLASSIFICATIE_BE, BODEMCLASSIFICATIE_WRB, BODEMCLASSIFICATIE_EXTRA, BODEMKUNDIGEOPBOUW, BODEMDIEPTEINTERVAL, BODEMMONSTER, BODEMOBSERVATIE, BODEMOBSERVATIEPLAN, VOORAFMELDING, NULMELDING, BEMALING, INSTRUMENT, SENSOR, TERREINVINPROEF, GEOLABOPROEVEN, VOLUMEMASSA, WATERGEHALTE, SAMENDRUKKING, LABOVIN, TRIAXIAAL, GEOCORE, BOORMEESTEROPLEIDING, BOORBEDRIJF, OBSERVATIE, UNKNOWN].

compensatieData.instrument.objectBeheer.id

Integer

true

Technisch id.

compensatieData.instrument.objectBeheer.status.code

String

false

Unieke identificatie van het element.

Veld mag geen spaties bevatten.
code moet 1 tot 10 karakters zijn.

compensatieData.instrument.objectBeheer.status.beschrijving

String

false

Beschrijving van het element.

beschrijving moet 1 tot 50 karakters zijn.

compensatieData.instrument.objectBeheer.databeheerder.id

String

true

Technisch id.

compensatieData.instrument.objectBeheer.leesgroepen.id

String

true

Technisch id.

compensatieData.instrument.objectBeheer.leesgroepen.leden[].id

String

true

Technisch id.

compensatieData.compensaties[].id

Integer

true

Technisch id.

compensatieData.compensaties[].sensor.id

String

true

Technisch id.

compensatieData.compensaties[].sensor.permKey

String

true

Permanente identifier.

compensatieData.compensaties[].sensor.domainObjectType

String

true

Moet 1 van volgende waarden zijn [BORING, DOSSIER, OPDRACHT, INTERPRETATIE, SONDERING, XML, PUT, TYPEPUT, GWLOCATIE, FILTER, FILTERGROEP, TYPEFILTER, WATERMONSTER, GRONDMONSTER, MONSTER, PERCEELANALYSE, BODEMSITE, BODEMLOCATIE, EXPLOITANT, IIOA, IIOA_BESLISSING, INSTALLATIE, VERGUNNING, VERGUNNING_PROCEDURE, VERGUNNING_MASTER, BODEMCLASSIFICATIE_BE, BODEMCLASSIFICATIE_WRB, BODEMCLASSIFICATIE_EXTRA, BODEMKUNDIGEOPBOUW, BODEMDIEPTEINTERVAL, BODEMMONSTER, BODEMOBSERVATIE, BODEMOBSERVATIEPLAN, VOORAFMELDING, NULMELDING, BEMALING, INSTRUMENT, SENSOR, TERREINVINPROEF, GEOLABOPROEVEN, VOLUMEMASSA, WATERGEHALTE, SAMENDRUKKING, LABOVIN, TRIAXIAAL, GEOCORE, BOORMEESTEROPLEIDING, BOORBEDRIJF, OBSERVATIE, UNKNOWN].

compensatieData.compensaties[].sensor.objectBeheer.id

Integer

true

Technisch id.

compensatieData.compensaties[].sensor.objectBeheer.status.code

String

false

Unieke identificatie van het element.

Veld mag geen spaties bevatten.
code moet 1 tot 10 karakters zijn.

compensatieData.compensaties[].sensor.objectBeheer.status.beschrijving

String

false

Beschrijving van het element.

beschrijving moet 1 tot 50 karakters zijn.

compensatieData.compensaties[].sensor.objectBeheer.databeheerder.id

String

true

Technisch id.

compensatieData.compensaties[].sensor.objectBeheer.leesgroepen.id

String

true

Technisch id.

compensatieData.compensaties[].sensor.objectBeheer.leesgroepen.leden[].id

String

true

Technisch id.

compensatieData.compensaties[].instrument.id

String

true

Technisch id.

compensatieData.compensaties[].instrument.permKey

String

true

Permanente identifier.

compensatieData.compensaties[].instrument.domainObjectType

String

true

Moet 1 van volgende waarden zijn [BORING, DOSSIER, OPDRACHT, INTERPRETATIE, SONDERING, XML, PUT, TYPEPUT, GWLOCATIE, FILTER, FILTERGROEP, TYPEFILTER, WATERMONSTER, GRONDMONSTER, MONSTER, PERCEELANALYSE, BODEMSITE, BODEMLOCATIE, EXPLOITANT, IIOA, IIOA_BESLISSING, INSTALLATIE, VERGUNNING, VERGUNNING_PROCEDURE, VERGUNNING_MASTER, BODEMCLASSIFICATIE_BE, BODEMCLASSIFICATIE_WRB, BODEMCLASSIFICATIE_EXTRA, BODEMKUNDIGEOPBOUW, BODEMDIEPTEINTERVAL, BODEMMONSTER, BODEMOBSERVATIE, BODEMOBSERVATIEPLAN, VOORAFMELDING, NULMELDING, BEMALING, INSTRUMENT, SENSOR, TERREINVINPROEF, GEOLABOPROEVEN, VOLUMEMASSA, WATERGEHALTE, SAMENDRUKKING, LABOVIN, TRIAXIAAL, GEOCORE, BOORMEESTEROPLEIDING, BOORBEDRIJF, OBSERVATIE, UNKNOWN].

compensatieData.compensaties[].instrument.objectBeheer.id

Integer

true

Technisch id.

compensatieData.compensaties[].instrument.objectBeheer.status.code

String

false

Unieke identificatie van het element.

Veld mag geen spaties bevatten.
code moet 1 tot 10 karakters zijn.

compensatieData.compensaties[].instrument.objectBeheer.status.beschrijving

String

false

Beschrijving van het element.

beschrijving moet 1 tot 50 karakters zijn.

compensatieData.compensaties[].instrument.objectBeheer.databeheerder.id

String

true

Technisch id.

compensatieData.compensaties[].instrument.objectBeheer.leesgroepen.id

String

true

Technisch id.

compensatieData.compensaties[].instrument.objectBeheer.leesgroepen.leden[].id

String

true

Technisch id.

compensatieData.compensaties[].compensatie.code

String

false

Unieke identificatie van het element.

compensatieData.compensaties[].compensatie.beschrijving

String

false

Beschrijving van het element.

compensatieData.id

Integer

true

Technisch id.

Updaten

Een instrument kan geüpdated worden door een PUT request te doen naar de server met in de body een json die de data bevat om een instrument te updaten.

Het is de query parameter "idOrPermkey" die het id of permkey van het instrument bepaalt.

Sensoren kunnen gedefinieerd worden volgens hun id, permkey of naam. Id heeft prioriteit op permkey en permkey heeft prioriteit op naam.

Lijsten, namelijk sensoren en compensaties moeten steeds volledig meegegeven worden. Indien een sensor of compensatie niet aanwezig is in de lijst, zal deze normaalgezien verwijderd worden (tenzij de validatie dit verhinderd). Indien geen id of permkey meegegeven is gaat de update er vanuit dat dit een nieuw item is in de lijst en zal dit item aangemaakt worden. Anders wordt het item geüpdated.

Compensaties hangen steeds aan een sensor. Voor de identificatie van deze sensor kan zowel het id, de permkey of naam van de sensor meegegeven worden. Hierbij is 1 van de drie verplicht. Id heeft voorang op permkey en permkey heeft voorang op sensor.

PUT /hfmetingen/instrumenten/{idOrPermkey}

Path parameters
Parameter Type Optioneel Beschrijving

idOrPermkey

String

false
Query parameters

Geen parameters.

Voorbeeld minimale json
{
   "id": 195,
   "metadata":{
      "naam":"JSY Test 002",
      "type":{
         "code":"TMS-NB"
      },
      "serienummer":"SEJSY02",
      "datumInGebruik":"2022-08-02"
   },
   "objectBeheer":{
      "id": 198,
      "status":{
         "code":"4"
      },
      "databeheerder":{
         "id":"10"
      }
   },
   "sensorData":{
      "sensoren":[
         {
            "id": 369,
            "naam":"T1",
            "parameter":{
               "id":"1911"
            },
            "sensorIdentificatie":{
               "code":"CN_T1"
            },
            "meeteenheid":{
               "code":"3"
            }
         },
         {
            "id": 370,
            "naam":"T2",
            "parameter":{
               "id":"1911"
            },
            "sensorIdentificatie":{
               "code":"CN_T2"
            },
            "meeteenheid":{
               "code":"3"
            }
         },
         {
            "id": 371,
            "naam":"T3",
            "parameter":{
               "id":"1911"
            },
            "sensorIdentificatie":{
               "code":"CN_T3"
            },
            "meeteenheid":{
               "code":"3"
            }
         },
         {
            "id": 372,
            "naam":"V1",
            "parameter":{
               "id":"1912"
            },
            "sensorIdentificatie":{
               "code":"CN_SWC"
            },
            "meeteenheid":{
               "code":"127"
            }
         }
      ]
   }
}
Voorbeeld minimale json met status gedeeld en leesgroepen (gedeelde status kan niet zonder leesgroepen erbij)
{
   "id": 195,
   "metadata":{
      "naam":"JSY Test 002",
      "type":{
         "code":"TMS-NB"
      },
      "serienummer":"SEJSY02",
      "datumInGebruik":"2022-08-02"
   },
   "objectBeheer":{
      "id": 198,
      "status":{
         "code":"3" /*status gedeeld*/
      },
      "databeheerder":{
         "id":"10"
      },
      "leesgroepen":{
        "id": "1" /*alleen id*/
      }
   },
   "sensorData":{
      "sensoren":[
         {
            "id": 369,
            "naam":"T1",
            "parameter":{
               "id":"1911"
            },
            "sensorIdentificatie":{
               "code":"CN_T1"
            },
            "meeteenheid":{
               "code":"3"
            }
         },
         {
            "id": 370,
            "naam":"T2",
            "parameter":{
               "id":"1911"
            },
            "sensorIdentificatie":{
               "code":"CN_T2"
            },
            "meeteenheid":{
               "code":"3"
            }
         },
         {
            "id": 371,
            "naam":"T3",
            "parameter":{
               "id":"1911"
            },
            "sensorIdentificatie":{
               "code":"CN_T3"
            },
            "meeteenheid":{
               "code":"3"
            }
         },
         {
            "id": 372,
            "naam":"V1",
            "parameter":{
               "id":"1912"
            },
            "sensorIdentificatie":{
               "code":"CN_SWC"
            },
            "meeteenheid":{
               "code":"127"
            }
         }
      ]
   }
}
Voorbeeld request
PUT /base/instrumenten/2021-000092 HTTP/1.1
Content-Type: application/json
Accept: application/json
Content-Length: 12133
Host: services.dov.vlaanderen.be:8080

{
  "id" : 97,
  "permKey" : "2021-000092",
  "metadata" : {
    "id" : 97,
    "naam" : "IMPORT_JSY_1",
    "type" : {
      "code" : "TMS-NB",
      "beschrijving" : "Temperature Moisture Sensor - NarrowBand"
    },
    "serienummer" : "IMP_1_DOLK",
    "referentie" : "Import curieuzeneuze dolk",
    "datumInGebruik" : "2021-03-01T00:00:00.000+00:00",
    "datumUitGebruik" : null,
    "typeNummer" : {
      "code" : "CN_ONB",
      "beschrijving" : "Curieuzeneuze Onbekend",
      "merk" : {
        "code" : "CN_DLK",
        "beschrijving" : "GazonDolk",
        "fabrikant" : {
          "code" : "CN",
          "beschrijving" : "Curieuzeneuze"
        }
      },
      "instrumentType" : null
    },
    "locatieStatus" : null,
    "batterijLaatstVervangen" : null,
    "transmissie" : null
  },
  "objectBeheer" : {
    "id" : 98,
    "status" : {
      "code" : "4",
      "beschrijving" : "Publiek"
    },
    "databeheerder" : {
      "id" : "8",
      "kbonummer" : null,
      "ovocode" : null,
      "naam" : "VMM"
    },
    "leesgroepen" : null
  },
  "sensorData" : {
    "instrument" : {
      "id" : "97",
      "permKey" : "2021-000092",
      "domainObjectType" : null,
      "naam" : "IMPORT_JSY_1",
      "objectBeheer" : {
        "id" : 98,
        "status" : {
          "code" : "4",
          "beschrijving" : "Publiek"
        },
        "databeheerder" : {
          "id" : "8",
          "kbonummer" : null,
          "ovocode" : null,
          "naam" : "VMM"
        },
        "leesgroepen" : null
      }
    },
    "sensoren" : [ {
      "id" : 112,
      "permKey" : "2021-000084",
      "naam" : "SWC1",
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "parameter" : {
        "id" : "CN_SWC",
        "korteNaam" : null,
        "beschrijving" : null,
        "betekenis" : null,
        "volgnummer" : null,
        "parametergroep" : null,
        "meeteenheid" : null,
        "bovengrens" : null,
        "ondergrens" : null,
        "displayformat" : null,
        "casRegistryNumber" : null,
        "ecNumber" : null,
        "valueType" : null,
        "fixed" : false,
        "analysemethodes" : [ ],
        "standaardgroepen" : [ ],
        "meeteenheden" : [ ],
        "keuzeLijst" : null,
        "meetpuntParameter" : null,
        "meetwaardeParameter" : null,
        "primair" : false,
        "secundair" : false
      },
      "sensorIdentificatie" : {
        "code" : "CN_SWC",
        "beschrijving" : "Curieuzeneuzen volumetrisch vochtgehalte X",
        "instrumentType" : {
          "code" : "TMS-NB",
          "beschrijving" : "Temperature Moisture Sensor - NarrowBand"
        }
      },
      "meeteenheid" : {
        "code" : "127",
        "beschrijving" : null,
        "afkorting" : null
      },
      "aantalDataPunten" : 0,
      "eersteData" : null,
      "laatsteData" : null,
      "laatsteImportLog" : null,
      "nauwkeurigheid" : null,
      "precisie" : null,
      "meetbereikVan" : null,
      "meetbereikTot" : null,
      "businessKey" : "SWC1"
    }, {
      "id" : 113,
      "permKey" : "2021-000085",
      "naam" : "T1",
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "parameter" : {
        "id" : "4017",
        "korteNaam" : null,
        "beschrijving" : null,
        "betekenis" : null,
        "volgnummer" : null,
        "parametergroep" : null,
        "meeteenheid" : null,
        "bovengrens" : null,
        "ondergrens" : null,
        "displayformat" : null,
        "casRegistryNumber" : null,
        "ecNumber" : null,
        "valueType" : null,
        "fixed" : false,
        "analysemethodes" : [ ],
        "standaardgroepen" : [ ],
        "meeteenheden" : [ ],
        "keuzeLijst" : null,
        "meetpuntParameter" : null,
        "meetwaardeParameter" : null,
        "primair" : false,
        "secundair" : false
      },
      "sensorIdentificatie" : {
        "code" : "CN_T1",
        "beschrijving" : "Curieuzeneuzen temperatuur boven maaiveld",
        "instrumentType" : {
          "code" : "TMS-NB",
          "beschrijving" : "Temperature Moisture Sensor - NarrowBand"
        }
      },
      "meeteenheid" : {
        "code" : "3",
        "beschrijving" : null,
        "afkorting" : null
      },
      "aantalDataPunten" : 0,
      "eersteData" : null,
      "laatsteData" : null,
      "laatsteImportLog" : null,
      "nauwkeurigheid" : null,
      "precisie" : null,
      "meetbereikVan" : null,
      "meetbereikTot" : null,
      "businessKey" : "T1"
    }, {
      "id" : 114,
      "permKey" : "2021-000086",
      "naam" : "T2",
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "parameter" : {
        "id" : "4017",
        "korteNaam" : null,
        "beschrijving" : null,
        "betekenis" : null,
        "volgnummer" : null,
        "parametergroep" : null,
        "meeteenheid" : null,
        "bovengrens" : null,
        "ondergrens" : null,
        "displayformat" : null,
        "casRegistryNumber" : null,
        "ecNumber" : null,
        "valueType" : null,
        "fixed" : false,
        "analysemethodes" : [ ],
        "standaardgroepen" : [ ],
        "meeteenheden" : [ ],
        "keuzeLijst" : null,
        "meetpuntParameter" : null,
        "meetwaardeParameter" : null,
        "primair" : false,
        "secundair" : false
      },
      "sensorIdentificatie" : {
        "code" : "CN_T2",
        "beschrijving" : "Curieuzeneuzen temperatuur op maaiveld",
        "instrumentType" : {
          "code" : "TMS-NB",
          "beschrijving" : "Temperature Moisture Sensor - NarrowBand"
        }
      },
      "meeteenheid" : {
        "code" : "3",
        "beschrijving" : null,
        "afkorting" : null
      },
      "aantalDataPunten" : 0,
      "eersteData" : null,
      "laatsteData" : null,
      "laatsteImportLog" : null,
      "nauwkeurigheid" : null,
      "precisie" : null,
      "meetbereikVan" : null,
      "meetbereikTot" : null,
      "businessKey" : "T2"
    }, {
      "id" : 115,
      "permKey" : "2021-000087",
      "naam" : "T3",
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "parameter" : {
        "id" : "4017",
        "korteNaam" : null,
        "beschrijving" : null,
        "betekenis" : null,
        "volgnummer" : null,
        "parametergroep" : null,
        "meeteenheid" : null,
        "bovengrens" : null,
        "ondergrens" : null,
        "displayformat" : null,
        "casRegistryNumber" : null,
        "ecNumber" : null,
        "valueType" : null,
        "fixed" : false,
        "analysemethodes" : [ ],
        "standaardgroepen" : [ ],
        "meeteenheden" : [ ],
        "keuzeLijst" : null,
        "meetpuntParameter" : null,
        "meetwaardeParameter" : null,
        "primair" : false,
        "secundair" : false
      },
      "sensorIdentificatie" : {
        "code" : "CN_T3",
        "beschrijving" : "Curieuzeneuzen temperatuur onder maaiveld",
        "instrumentType" : {
          "code" : "TMS-NB",
          "beschrijving" : "Temperature Moisture Sensor - NarrowBand"
        }
      },
      "meeteenheid" : {
        "code" : "3",
        "beschrijving" : null,
        "afkorting" : null
      },
      "aantalDataPunten" : 0,
      "eersteData" : null,
      "laatsteData" : null,
      "laatsteImportLog" : null,
      "nauwkeurigheid" : null,
      "precisie" : null,
      "meetbereikVan" : null,
      "meetbereikTot" : null,
      "businessKey" : "T3"
    } ],
    "id" : 97
  },
  "compensatieData" : {
    "instrument" : {
      "id" : "97",
      "permKey" : "2021-000092",
      "domainObjectType" : null,
      "naam" : "IMPORT_JSY_1",
      "objectBeheer" : {
        "id" : 98,
        "status" : {
          "code" : "4",
          "beschrijving" : "Publiek"
        },
        "databeheerder" : {
          "id" : "8",
          "kbonummer" : null,
          "ovocode" : null,
          "naam" : "VMM"
        },
        "leesgroepen" : null
      }
    },
    "compensaties" : [ {
      "id" : 41,
      "sensor" : {
        "id" : "113",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : "T1",
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "van" : "01-05-2021 00:00:00",
      "tot" : null,
      "compensatie" : {
        "code" : "CAP",
        "beschrijving" : "Gecompenseerd via capillair"
      },
      "businessKey" : "T1"
    }, {
      "id" : 42,
      "sensor" : {
        "id" : "115",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : "T3",
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "van" : "02-05-2021 00:00:00",
      "tot" : "04-05-2021 00:00:00",
      "compensatie" : {
        "code" : "NT",
        "beschrijving" : "Niet gecompenseerd"
      },
      "businessKey" : "T3"
    } ],
    "id" : 97
  }
}
Voorbeeld request body
PUT /base/instrumenten/2021-000092 HTTP/1.1
Content-Type: application/json
Accept: application/json
Content-Length: 12133
Host: services.dov.vlaanderen.be:8080

{
  "id" : 97,
  "permKey" : "2021-000092",
  "metadata" : {
    "id" : 97,
    "naam" : "IMPORT_JSY_1",
    "type" : {
      "code" : "TMS-NB",
      "beschrijving" : "Temperature Moisture Sensor - NarrowBand"
    },
    "serienummer" : "IMP_1_DOLK",
    "referentie" : "Import curieuzeneuze dolk",
    "datumInGebruik" : "2021-03-01T00:00:00.000+00:00",
    "datumUitGebruik" : null,
    "typeNummer" : {
      "code" : "CN_ONB",
      "beschrijving" : "Curieuzeneuze Onbekend",
      "merk" : {
        "code" : "CN_DLK",
        "beschrijving" : "GazonDolk",
        "fabrikant" : {
          "code" : "CN",
          "beschrijving" : "Curieuzeneuze"
        }
      },
      "instrumentType" : null
    },
    "locatieStatus" : null,
    "batterijLaatstVervangen" : null,
    "transmissie" : null
  },
  "objectBeheer" : {
    "id" : 98,
    "status" : {
      "code" : "4",
      "beschrijving" : "Publiek"
    },
    "databeheerder" : {
      "id" : "8",
      "kbonummer" : null,
      "ovocode" : null,
      "naam" : "VMM"
    },
    "leesgroepen" : null
  },
  "sensorData" : {
    "instrument" : {
      "id" : "97",
      "permKey" : "2021-000092",
      "domainObjectType" : null,
      "naam" : "IMPORT_JSY_1",
      "objectBeheer" : {
        "id" : 98,
        "status" : {
          "code" : "4",
          "beschrijving" : "Publiek"
        },
        "databeheerder" : {
          "id" : "8",
          "kbonummer" : null,
          "ovocode" : null,
          "naam" : "VMM"
        },
        "leesgroepen" : null
      }
    },
    "sensoren" : [ {
      "id" : 112,
      "permKey" : "2021-000084",
      "naam" : "SWC1",
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "parameter" : {
        "id" : "CN_SWC",
        "korteNaam" : null,
        "beschrijving" : null,
        "betekenis" : null,
        "volgnummer" : null,
        "parametergroep" : null,
        "meeteenheid" : null,
        "bovengrens" : null,
        "ondergrens" : null,
        "displayformat" : null,
        "casRegistryNumber" : null,
        "ecNumber" : null,
        "valueType" : null,
        "fixed" : false,
        "analysemethodes" : [ ],
        "standaardgroepen" : [ ],
        "meeteenheden" : [ ],
        "keuzeLijst" : null,
        "meetpuntParameter" : null,
        "meetwaardeParameter" : null,
        "primair" : false,
        "secundair" : false
      },
      "sensorIdentificatie" : {
        "code" : "CN_SWC",
        "beschrijving" : "Curieuzeneuzen volumetrisch vochtgehalte X",
        "instrumentType" : {
          "code" : "TMS-NB",
          "beschrijving" : "Temperature Moisture Sensor - NarrowBand"
        }
      },
      "meeteenheid" : {
        "code" : "127",
        "beschrijving" : null,
        "afkorting" : null
      },
      "aantalDataPunten" : 0,
      "eersteData" : null,
      "laatsteData" : null,
      "laatsteImportLog" : null,
      "nauwkeurigheid" : null,
      "precisie" : null,
      "meetbereikVan" : null,
      "meetbereikTot" : null,
      "businessKey" : "SWC1"
    }, {
      "id" : 113,
      "permKey" : "2021-000085",
      "naam" : "T1",
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "parameter" : {
        "id" : "4017",
        "korteNaam" : null,
        "beschrijving" : null,
        "betekenis" : null,
        "volgnummer" : null,
        "parametergroep" : null,
        "meeteenheid" : null,
        "bovengrens" : null,
        "ondergrens" : null,
        "displayformat" : null,
        "casRegistryNumber" : null,
        "ecNumber" : null,
        "valueType" : null,
        "fixed" : false,
        "analysemethodes" : [ ],
        "standaardgroepen" : [ ],
        "meeteenheden" : [ ],
        "keuzeLijst" : null,
        "meetpuntParameter" : null,
        "meetwaardeParameter" : null,
        "primair" : false,
        "secundair" : false
      },
      "sensorIdentificatie" : {
        "code" : "CN_T1",
        "beschrijving" : "Curieuzeneuzen temperatuur boven maaiveld",
        "instrumentType" : {
          "code" : "TMS-NB",
          "beschrijving" : "Temperature Moisture Sensor - NarrowBand"
        }
      },
      "meeteenheid" : {
        "code" : "3",
        "beschrijving" : null,
        "afkorting" : null
      },
      "aantalDataPunten" : 0,
      "eersteData" : null,
      "laatsteData" : null,
      "laatsteImportLog" : null,
      "nauwkeurigheid" : null,
      "precisie" : null,
      "meetbereikVan" : null,
      "meetbereikTot" : null,
      "businessKey" : "T1"
    }, {
      "id" : 114,
      "permKey" : "2021-000086",
      "naam" : "T2",
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "parameter" : {
        "id" : "4017",
        "korteNaam" : null,
        "beschrijving" : null,
        "betekenis" : null,
        "volgnummer" : null,
        "parametergroep" : null,
        "meeteenheid" : null,
        "bovengrens" : null,
        "ondergrens" : null,
        "displayformat" : null,
        "casRegistryNumber" : null,
        "ecNumber" : null,
        "valueType" : null,
        "fixed" : false,
        "analysemethodes" : [ ],
        "standaardgroepen" : [ ],
        "meeteenheden" : [ ],
        "keuzeLijst" : null,
        "meetpuntParameter" : null,
        "meetwaardeParameter" : null,
        "primair" : false,
        "secundair" : false
      },
      "sensorIdentificatie" : {
        "code" : "CN_T2",
        "beschrijving" : "Curieuzeneuzen temperatuur op maaiveld",
        "instrumentType" : {
          "code" : "TMS-NB",
          "beschrijving" : "Temperature Moisture Sensor - NarrowBand"
        }
      },
      "meeteenheid" : {
        "code" : "3",
        "beschrijving" : null,
        "afkorting" : null
      },
      "aantalDataPunten" : 0,
      "eersteData" : null,
      "laatsteData" : null,
      "laatsteImportLog" : null,
      "nauwkeurigheid" : null,
      "precisie" : null,
      "meetbereikVan" : null,
      "meetbereikTot" : null,
      "businessKey" : "T2"
    }, {
      "id" : 115,
      "permKey" : "2021-000087",
      "naam" : "T3",
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "parameter" : {
        "id" : "4017",
        "korteNaam" : null,
        "beschrijving" : null,
        "betekenis" : null,
        "volgnummer" : null,
        "parametergroep" : null,
        "meeteenheid" : null,
        "bovengrens" : null,
        "ondergrens" : null,
        "displayformat" : null,
        "casRegistryNumber" : null,
        "ecNumber" : null,
        "valueType" : null,
        "fixed" : false,
        "analysemethodes" : [ ],
        "standaardgroepen" : [ ],
        "meeteenheden" : [ ],
        "keuzeLijst" : null,
        "meetpuntParameter" : null,
        "meetwaardeParameter" : null,
        "primair" : false,
        "secundair" : false
      },
      "sensorIdentificatie" : {
        "code" : "CN_T3",
        "beschrijving" : "Curieuzeneuzen temperatuur onder maaiveld",
        "instrumentType" : {
          "code" : "TMS-NB",
          "beschrijving" : "Temperature Moisture Sensor - NarrowBand"
        }
      },
      "meeteenheid" : {
        "code" : "3",
        "beschrijving" : null,
        "afkorting" : null
      },
      "aantalDataPunten" : 0,
      "eersteData" : null,
      "laatsteData" : null,
      "laatsteImportLog" : null,
      "nauwkeurigheid" : null,
      "precisie" : null,
      "meetbereikVan" : null,
      "meetbereikTot" : null,
      "businessKey" : "T3"
    } ],
    "id" : 97
  },
  "compensatieData" : {
    "instrument" : {
      "id" : "97",
      "permKey" : "2021-000092",
      "domainObjectType" : null,
      "naam" : "IMPORT_JSY_1",
      "objectBeheer" : {
        "id" : 98,
        "status" : {
          "code" : "4",
          "beschrijving" : "Publiek"
        },
        "databeheerder" : {
          "id" : "8",
          "kbonummer" : null,
          "ovocode" : null,
          "naam" : "VMM"
        },
        "leesgroepen" : null
      }
    },
    "compensaties" : [ {
      "id" : 41,
      "sensor" : {
        "id" : "113",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : "T1",
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "van" : "01-05-2021 00:00:00",
      "tot" : null,
      "compensatie" : {
        "code" : "CAP",
        "beschrijving" : "Gecompenseerd via capillair"
      },
      "businessKey" : "T1"
    }, {
      "id" : 42,
      "sensor" : {
        "id" : "115",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : "T3",
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "van" : "02-05-2021 00:00:00",
      "tot" : "04-05-2021 00:00:00",
      "compensatie" : {
        "code" : "NT",
        "beschrijving" : "Niet gecompenseerd"
      },
      "businessKey" : "T3"
    } ],
    "id" : 97
  }
}
Voorbeeld response body: succes
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 10226

{
  "id" : 97,
  "permKey" : "2021-000092",
  "metadata" : {
    "id" : 97,
    "naam" : "IMPORT_JSY_1",
    "type" : {
      "code" : "TMS-NB",
      "beschrijving" : "Temperature Moisture Sensor - NarrowBand"
    },
    "serienummer" : "IMP_1_DOLK",
    "referentie" : "Import curieuzeneuze dolk",
    "datumInGebruik" : "2021-03-01T00:00:00.000+00:00",
    "datumUitGebruik" : null,
    "typeNummer" : {
      "code" : "CN_ONB",
      "beschrijving" : "Curieuzeneuze Onbekend",
      "merk" : {
        "code" : "CN_DLK",
        "beschrijving" : "GazonDolk",
        "fabrikant" : {
          "code" : "CN",
          "beschrijving" : "Curieuzeneuze"
        }
      },
      "instrumentType" : null
    },
    "locatieStatus" : null,
    "batterijLaatstVervangen" : null,
    "transmissie" : null
  },
  "objectBeheer" : {
    "id" : 98,
    "status" : {
      "code" : "4",
      "beschrijving" : "Publiek"
    },
    "databeheerder" : {
      "id" : "8",
      "kbonummer" : null,
      "ovocode" : null,
      "naam" : "VMM"
    },
    "leesgroepen" : null
  },
  "sensorData" : {
    "instrument" : {
      "id" : "97",
      "permKey" : "2021-000092",
      "domainObjectType" : null,
      "naam" : "IMPORT_JSY_1",
      "objectBeheer" : {
        "id" : 98,
        "status" : {
          "code" : "4",
          "beschrijving" : "Publiek"
        },
        "databeheerder" : {
          "id" : "8",
          "kbonummer" : null,
          "ovocode" : null,
          "naam" : "VMM"
        },
        "leesgroepen" : null
      }
    },
    "sensoren" : [ {
      "id" : 112,
      "permKey" : "2021-000084",
      "naam" : "SWC1",
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "parameter" : {
        "id" : "CN_SWC",
        "korteNaam" : null,
        "beschrijving" : null,
        "betekenis" : null,
        "volgnummer" : null,
        "parametergroep" : null,
        "meeteenheid" : null,
        "bovengrens" : null,
        "ondergrens" : null,
        "displayformat" : null,
        "casRegistryNumber" : null,
        "ecNumber" : null,
        "valueType" : null,
        "fixed" : false,
        "analysemethodes" : [ ],
        "standaardgroepen" : [ ],
        "meeteenheden" : [ ],
        "keuzeLijst" : null,
        "meetpuntParameter" : null,
        "meetwaardeParameter" : null,
        "primair" : false,
        "secundair" : false
      },
      "sensorIdentificatie" : {
        "code" : "CN_SWC",
        "beschrijving" : "Curieuzeneuzen volumetrisch vochtgehalte X",
        "instrumentType" : {
          "code" : "TMS-NB",
          "beschrijving" : "Temperature Moisture Sensor - NarrowBand"
        }
      },
      "meeteenheid" : {
        "code" : "127",
        "beschrijving" : null,
        "afkorting" : null
      },
      "aantalDataPunten" : 0,
      "eersteData" : null,
      "laatsteData" : null,
      "laatsteImportLog" : null,
      "nauwkeurigheid" : null,
      "precisie" : null,
      "meetbereikVan" : null,
      "meetbereikTot" : null,
      "businessKey" : "SWC1"
    }, {
      "id" : 113,
      "permKey" : "2021-000085",
      "naam" : "T1",
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "parameter" : {
        "id" : "4017",
        "korteNaam" : null,
        "beschrijving" : null,
        "betekenis" : null,
        "volgnummer" : null,
        "parametergroep" : null,
        "meeteenheid" : null,
        "bovengrens" : null,
        "ondergrens" : null,
        "displayformat" : null,
        "casRegistryNumber" : null,
        "ecNumber" : null,
        "valueType" : null,
        "fixed" : false,
        "analysemethodes" : [ ],
        "standaardgroepen" : [ ],
        "meeteenheden" : [ ],
        "keuzeLijst" : null,
        "meetpuntParameter" : null,
        "meetwaardeParameter" : null,
        "primair" : false,
        "secundair" : false
      },
      "sensorIdentificatie" : {
        "code" : "CN_T1",
        "beschrijving" : "Curieuzeneuzen temperatuur boven maaiveld",
        "instrumentType" : {
          "code" : "TMS-NB",
          "beschrijving" : "Temperature Moisture Sensor - NarrowBand"
        }
      },
      "meeteenheid" : {
        "code" : "3",
        "beschrijving" : null,
        "afkorting" : null
      },
      "aantalDataPunten" : 0,
      "eersteData" : null,
      "laatsteData" : null,
      "laatsteImportLog" : null,
      "nauwkeurigheid" : null,
      "precisie" : null,
      "meetbereikVan" : null,
      "meetbereikTot" : null,
      "businessKey" : "T1"
    }, {
      "id" : 114,
      "permKey" : "2021-000086",
      "naam" : "T2",
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "parameter" : {
        "id" : "4017",
        "korteNaam" : null,
        "beschrijving" : null,
        "betekenis" : null,
        "volgnummer" : null,
        "parametergroep" : null,
        "meeteenheid" : null,
        "bovengrens" : null,
        "ondergrens" : null,
        "displayformat" : null,
        "casRegistryNumber" : null,
        "ecNumber" : null,
        "valueType" : null,
        "fixed" : false,
        "analysemethodes" : [ ],
        "standaardgroepen" : [ ],
        "meeteenheden" : [ ],
        "keuzeLijst" : null,
        "meetpuntParameter" : null,
        "meetwaardeParameter" : null,
        "primair" : false,
        "secundair" : false
      },
      "sensorIdentificatie" : {
        "code" : "CN_T2",
        "beschrijving" : "Curieuzeneuzen temperatuur op maaiveld",
        "instrumentType" : {
          "code" : "TMS-NB",
          "beschrijving" : "Temperature Moisture Sensor - NarrowBand"
        }
      },
      "meeteenheid" : {
        "code" : "3",
        "beschrijving" : null,
        "afkorting" : null
      },
      "aantalDataPunten" : 0,
      "eersteData" : null,
      "laatsteData" : null,
      "laatsteImportLog" : null,
      "nauwkeurigheid" : null,
      "precisie" : null,
      "meetbereikVan" : null,
      "meetbereikTot" : null,
      "businessKey" : "T2"
    } ],
    "id" : 97
  },
  "compensatieData" : {
    "instrument" : {
      "id" : "97",
      "permKey" : "2021-000092",
      "domainObjectType" : null,
      "naam" : "IMPORT_JSY_1",
      "objectBeheer" : {
        "id" : 98,
        "status" : {
          "code" : "4",
          "beschrijving" : "Publiek"
        },
        "databeheerder" : {
          "id" : "8",
          "kbonummer" : null,
          "ovocode" : null,
          "naam" : "VMM"
        },
        "leesgroepen" : null
      }
    },
    "compensaties" : [ {
      "id" : 41,
      "sensor" : {
        "id" : "113",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : "T1",
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "van" : "01-05-2021 00:00:00",
      "tot" : null,
      "compensatie" : {
        "code" : "CAP",
        "beschrijving" : "Gecompenseerd via capillair"
      },
      "businessKey" : "T1"
    }, {
      "id" : 42,
      "sensor" : {
        "id" : "115",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : "T3",
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "instrument" : {
        "id" : "97",
        "permKey" : null,
        "domainObjectType" : null,
        "naam" : null,
        "objectBeheer" : {
          "id" : 98,
          "status" : {
            "code" : "4",
            "beschrijving" : "Publiek"
          },
          "databeheerder" : {
            "id" : "8",
            "kbonummer" : null,
            "ovocode" : null,
            "naam" : "VMM"
          },
          "leesgroepen" : null
        }
      },
      "van" : "02-05-2021 00:00:00",
      "tot" : "04-05-2021 00:00:00",
      "compensatie" : {
        "code" : "NT",
        "beschrijving" : "Niet gecompenseerd"
      },
      "businessKey" : "T3"
    } ],
    "id" : 97
  }
}
Beschrijving velden in de resonse body
Path Type Optioneel Beschrijving

id

Integer

true

Technisch id.

permKey

String

true

Permanente identifier.

metadata.id

Integer

true

Technisch id.

metadata.naam

String

true

Het veld mag niet leeg zijn.
Size must be between 0 and 100 inclusive.

metadata.type.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

metadata.type.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

metadata.serienummer

String

true

Het veld mag niet leeg zijn.
Size must be between 0 and 50 inclusive.

metadata.referentie

String

true

Size must be between 0 and 50 inclusive.

metadata.typeNummer.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 50 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

metadata.typeNummer.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 100 karakters zijn.

metadata.typeNummer.merk.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 50 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

metadata.typeNummer.merk.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 100 karakters zijn.

metadata.typeNummer.merk.fabrikant.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 50 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

metadata.typeNummer.merk.fabrikant.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

metadata.typeNummer.instrumentType.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

metadata.typeNummer.instrumentType.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

metadata.locatieStatus.code

String

false

Unieke identificatie van het element.

metadata.locatieStatus.beschrijving

String

false

Beschrijving van het element.

metadata.transmissie.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

metadata.transmissie.beschrijving

String

false

Beschrijving van het element.

objectBeheer.id

Integer

true

Technisch id.

objectBeheer.status.code

String

false

Unieke identificatie van het element.

Veld mag geen spaties bevatten.
code moet 1 tot 10 karakters zijn.

objectBeheer.status.beschrijving

String

false

Beschrijving van het element.

beschrijving moet 1 tot 50 karakters zijn.

objectBeheer.databeheerder.id

String

true

Technisch id.

objectBeheer.leesgroepen.id

String

true

Technisch id.

objectBeheer.leesgroepen.leden[].id

String

true

Technisch id.

sensorData.instrument.id

String

true

Technisch id.

sensorData.instrument.permKey

String

true

Permanente identifier.

sensorData.instrument.domainObjectType

String

true

Moet 1 van volgende waarden zijn [BORING, DOSSIER, OPDRACHT, INTERPRETATIE, SONDERING, XML, PUT, TYPEPUT, GWLOCATIE, FILTER, FILTERGROEP, TYPEFILTER, WATERMONSTER, GRONDMONSTER, MONSTER, PERCEELANALYSE, BODEMSITE, BODEMLOCATIE, EXPLOITANT, IIOA, IIOA_BESLISSING, INSTALLATIE, VERGUNNING, VERGUNNING_PROCEDURE, VERGUNNING_MASTER, BODEMCLASSIFICATIE_BE, BODEMCLASSIFICATIE_WRB, BODEMCLASSIFICATIE_EXTRA, BODEMKUNDIGEOPBOUW, BODEMDIEPTEINTERVAL, BODEMMONSTER, BODEMOBSERVATIE, BODEMOBSERVATIEPLAN, VOORAFMELDING, NULMELDING, BEMALING, INSTRUMENT, SENSOR, TERREINVINPROEF, GEOLABOPROEVEN, VOLUMEMASSA, WATERGEHALTE, SAMENDRUKKING, LABOVIN, TRIAXIAAL, GEOCORE, BOORMEESTEROPLEIDING, BOORBEDRIJF, OBSERVATIE, UNKNOWN].

sensorData.instrument.objectBeheer.id

Integer

true

Technisch id.

sensorData.instrument.objectBeheer.status.code

String

false

Unieke identificatie van het element.

Veld mag geen spaties bevatten.
code moet 1 tot 10 karakters zijn.

sensorData.instrument.objectBeheer.status.beschrijving

String

false

Beschrijving van het element.

beschrijving moet 1 tot 50 karakters zijn.

sensorData.instrument.objectBeheer.databeheerder.id

String

true

Technisch id.

sensorData.instrument.objectBeheer.leesgroepen.id

String

true

Technisch id.

sensorData.instrument.objectBeheer.leesgroepen.leden[].id

String

true

Technisch id.

sensorData.sensoren[].id

Integer

true

Technisch id.

sensorData.sensoren[].permKey

String

true

Permanente identifier.

sensorData.sensoren[].naam

String

false

Het veld mag niet leeg zijn.
Size must be between 0 and 100 inclusive.

sensorData.sensoren[].instrument.id

String

true

Technisch id.

sensorData.sensoren[].instrument.permKey

String

true

Permanente identifier.

sensorData.sensoren[].instrument.domainObjectType

String

true

Moet 1 van volgende waarden zijn [BORING, DOSSIER, OPDRACHT, INTERPRETATIE, SONDERING, XML, PUT, TYPEPUT, GWLOCATIE, FILTER, FILTERGROEP, TYPEFILTER, WATERMONSTER, GRONDMONSTER, MONSTER, PERCEELANALYSE, BODEMSITE, BODEMLOCATIE, EXPLOITANT, IIOA, IIOA_BESLISSING, INSTALLATIE, VERGUNNING, VERGUNNING_PROCEDURE, VERGUNNING_MASTER, BODEMCLASSIFICATIE_BE, BODEMCLASSIFICATIE_WRB, BODEMCLASSIFICATIE_EXTRA, BODEMKUNDIGEOPBOUW, BODEMDIEPTEINTERVAL, BODEMMONSTER, BODEMOBSERVATIE, BODEMOBSERVATIEPLAN, VOORAFMELDING, NULMELDING, BEMALING, INSTRUMENT, SENSOR, TERREINVINPROEF, GEOLABOPROEVEN, VOLUMEMASSA, WATERGEHALTE, SAMENDRUKKING, LABOVIN, TRIAXIAAL, GEOCORE, BOORMEESTEROPLEIDING, BOORBEDRIJF, OBSERVATIE, UNKNOWN].

sensorData.sensoren[].instrument.objectBeheer.id

Integer

true

Technisch id.

sensorData.sensoren[].instrument.objectBeheer.status.code

String

false

Unieke identificatie van het element.

Veld mag geen spaties bevatten.
code moet 1 tot 10 karakters zijn.

sensorData.sensoren[].instrument.objectBeheer.status.beschrijving

String

false

Beschrijving van het element.

beschrijving moet 1 tot 50 karakters zijn.

sensorData.sensoren[].instrument.objectBeheer.databeheerder.id

String

true

Technisch id.

sensorData.sensoren[].instrument.objectBeheer.leesgroepen.id

String

true

Technisch id.

sensorData.sensoren[].instrument.objectBeheer.leesgroepen.leden[].id

String

true

Technisch id.

sensorData.sensoren[].parameter.id

String

true

Technisch id.

sensorData.sensoren[].parameter.korteNaam

String

false

Korte naam moet 1 tot 50 karakters zijn.

sensorData.sensoren[].parameter.beschrijving

String

false

Beschrijving van het element.

Bechrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].parameter.parametergroep.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Veld mag geen spaties bevatten.

sensorData.sensoren[].parameter.parametergroep.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 100 karakters zijn.

sensorData.sensoren[].parameter.parametergroep.groepType

String

true

Moet 1 van volgende waarden zijn [W, G, B].

sensorData.sensoren[].parameter.meeteenheid.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Veld mag geen spaties bevatten.

sensorData.sensoren[].parameter.meeteenheid.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].parameter.meeteenheid.afkorting

String

false

Afkorting moet 1 tot 25 karakters zijn.

sensorData.sensoren[].parameter.displayformat

String

true

Weergave mag maximum 20 karakters zijn.

sensorData.sensoren[].parameter.casRegistryNumber

String

true

CAS nummer mag maximum 12 karakters zijn.

sensorData.sensoren[].parameter.ecNumber

String

true

EG-nummer mag maximum 9 karakters zijn.

sensorData.sensoren[].parameter.valueType

String

true

Moet 1 van volgende waarden zijn [NUM, TXT, BLANCO, REF, TM, MR, TMR].

sensorData.sensoren[].parameter.analysemethodes[].code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Veld mag geen spaties bevatten.

sensorData.sensoren[].parameter.analysemethodes[].beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].parameter.analysemethodes[].secundaireParameters[].id

String

true

Technisch id.

sensorData.sensoren[].parameter.standaardgroepen[].code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Veld mag geen spaties bevatten.

sensorData.sensoren[].parameter.standaardgroepen[].beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].parameter.meeteenheden[].id

String

true

Technisch id.

sensorData.sensoren[].parameter.meeteenheden[].meetEenheid.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Veld mag geen spaties bevatten.

sensorData.sensoren[].parameter.meeteenheden[].meetEenheid.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].parameter.meeteenheden[].meetEenheid.afkorting

String

false

Afkorting moet 1 tot 25 karakters zijn.

sensorData.sensoren[].parameter.meeteenheden[].omrekeningsformule

String

true

Moet 1 van volgende waarden zijn [LIN].

sensorData.sensoren[].parameter.meeteenheden[].displayformatNaam

String

true

Weergave mag maximum 10 karakters zijn.

sensorData.sensoren[].parameter.keuzeLijst[].code

String

true

Unieke identificatie van het element.

sensorData.sensoren[].parameter.keuzeLijst[].beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].sensorIdentificatie.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

sensorData.sensoren[].sensorIdentificatie.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].sensorIdentificatie.instrumentType.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Enkel alfanumerieke karakters toegelaten.
Veld mag geen spaties bevatten.

sensorData.sensoren[].sensorIdentificatie.instrumentType.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].meeteenheid.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Veld mag geen spaties bevatten.

sensorData.sensoren[].meeteenheid.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 255 karakters zijn.

sensorData.sensoren[].meeteenheid.afkorting

String

false

Afkorting moet 1 tot 25 karakters zijn.

sensorData.sensoren[].laatsteImportLog.id

Integer

true

Technisch id.

sensorData.sensoren[].laatsteImportLog.bestand.code

String

false

Unieke identificatie van het element.

sensorData.sensoren[].laatsteImportLog.bestand.beschrijving

String

false

Beschrijving van het element.

sensorData.sensoren[].laatsteImportLog.status

String

true

Moet 1 van volgende waarden zijn [NIET_VERWERKT, IN_VERWERKING, VERWERKT_MET_FOUTEN, VERWERKT_ZONDER_FOUTEN, VERWERKT_MET_WARNING, GEVALIDEERD_MET_FOUTEN, GEVALIDEERD_ZONDER_FOUTEN, GEVALIDEERD_MET_WARNING].

sensorData.sensoren[].laatsteImportLog.type

String

true

Moet 1 van volgende waarden zijn [UPLOAD_GUI_CSV, UPLOAD_REST_JSON, UPLOAD_REST_CSV, DELETE_GUI, DELETE_REST].

sensorData.sensoren[].laatsteImportLog.messages[].id

Integer

true

Technisch id.

sensorData.sensoren[].laatsteImportLog.messages[].severity

String

true

Moet 1 van volgende waarden zijn [FATAL, WARNING].

sensorData.sensoren[].nauwkeurigheid

Decimal

true

Must be at least 0.
Must be at most 100.
Must have at most 3 integral digits and 2 fractional digits.

sensorData.sensoren[].precisie

Decimal

true

Must be at least 0.
Must have at most 7 integral digits and 8 fractional digits.

sensorData.sensoren[].meetbereikVan

Decimal

true

Must have at most 7 integral digits and 8 fractional digits.

sensorData.sensoren[].meetbereikTot

Decimal

true

Must have at most 7 integral digits and 8 fractional digits.

sensorData.id

Integer

true

Technisch id.

compensatieData.instrument.id

String

true

Technisch id.

compensatieData.instrument.permKey

String

true

Permanente identifier.

compensatieData.instrument.domainObjectType

String

true

Moet 1 van volgende waarden zijn [BORING, DOSSIER, OPDRACHT, INTERPRETATIE, SONDERING, XML, PUT, TYPEPUT, GWLOCATIE, FILTER, FILTERGROEP, TYPEFILTER, WATERMONSTER, GRONDMONSTER, MONSTER, PERCEELANALYSE, BODEMSITE, BODEMLOCATIE, EXPLOITANT, IIOA, IIOA_BESLISSING, INSTALLATIE, VERGUNNING, VERGUNNING_PROCEDURE, VERGUNNING_MASTER, BODEMCLASSIFICATIE_BE, BODEMCLASSIFICATIE_WRB, BODEMCLASSIFICATIE_EXTRA, BODEMKUNDIGEOPBOUW, BODEMDIEPTEINTERVAL, BODEMMONSTER, BODEMOBSERVATIE, BODEMOBSERVATIEPLAN, VOORAFMELDING, NULMELDING, BEMALING, INSTRUMENT, SENSOR, TERREINVINPROEF, GEOLABOPROEVEN, VOLUMEMASSA, WATERGEHALTE, SAMENDRUKKING, LABOVIN, TRIAXIAAL, GEOCORE, BOORMEESTEROPLEIDING, BOORBEDRIJF, OBSERVATIE, UNKNOWN].

compensatieData.instrument.objectBeheer.id

Integer

true

Technisch id.

compensatieData.instrument.objectBeheer.status.code

String

false

Unieke identificatie van het element.

Veld mag geen spaties bevatten.
code moet 1 tot 10 karakters zijn.

compensatieData.instrument.objectBeheer.status.beschrijving

String

false

Beschrijving van het element.

beschrijving moet 1 tot 50 karakters zijn.

compensatieData.instrument.objectBeheer.databeheerder.id

String

true

Technisch id.

compensatieData.instrument.objectBeheer.leesgroepen.id

String

true

Technisch id.

compensatieData.instrument.objectBeheer.leesgroepen.leden[].id

String

true

Technisch id.

compensatieData.compensaties[].id

Integer

true

Technisch id.

compensatieData.compensaties[].sensor.id

String

true

Technisch id.

compensatieData.compensaties[].sensor.permKey

String

true

Permanente identifier.

compensatieData.compensaties[].sensor.domainObjectType

String

true

Moet 1 van volgende waarden zijn [BORING, DOSSIER, OPDRACHT, INTERPRETATIE, SONDERING, XML, PUT, TYPEPUT, GWLOCATIE, FILTER, FILTERGROEP, TYPEFILTER, WATERMONSTER, GRONDMONSTER, MONSTER, PERCEELANALYSE, BODEMSITE, BODEMLOCATIE, EXPLOITANT, IIOA, IIOA_BESLISSING, INSTALLATIE, VERGUNNING, VERGUNNING_PROCEDURE, VERGUNNING_MASTER, BODEMCLASSIFICATIE_BE, BODEMCLASSIFICATIE_WRB, BODEMCLASSIFICATIE_EXTRA, BODEMKUNDIGEOPBOUW, BODEMDIEPTEINTERVAL, BODEMMONSTER, BODEMOBSERVATIE, BODEMOBSERVATIEPLAN, VOORAFMELDING, NULMELDING, BEMALING, INSTRUMENT, SENSOR, TERREINVINPROEF, GEOLABOPROEVEN, VOLUMEMASSA, WATERGEHALTE, SAMENDRUKKING, LABOVIN, TRIAXIAAL, GEOCORE, BOORMEESTEROPLEIDING, BOORBEDRIJF, OBSERVATIE, UNKNOWN].

compensatieData.compensaties[].sensor.objectBeheer.id

Integer

true

Technisch id.

compensatieData.compensaties[].sensor.objectBeheer.status.code

String

false

Unieke identificatie van het element.

Veld mag geen spaties bevatten.
code moet 1 tot 10 karakters zijn.

compensatieData.compensaties[].sensor.objectBeheer.status.beschrijving

String

false

Beschrijving van het element.

beschrijving moet 1 tot 50 karakters zijn.

compensatieData.compensaties[].sensor.objectBeheer.databeheerder.id

String

true

Technisch id.

compensatieData.compensaties[].sensor.objectBeheer.leesgroepen.id

String

true

Technisch id.

compensatieData.compensaties[].sensor.objectBeheer.leesgroepen.leden[].id

String

true

Technisch id.

compensatieData.compensaties[].instrument.id

String

true

Technisch id.

compensatieData.compensaties[].instrument.permKey

String

true

Permanente identifier.

compensatieData.compensaties[].instrument.domainObjectType

String

true

Moet 1 van volgende waarden zijn [BORING, DOSSIER, OPDRACHT, INTERPRETATIE, SONDERING, XML, PUT, TYPEPUT, GWLOCATIE, FILTER, FILTERGROEP, TYPEFILTER, WATERMONSTER, GRONDMONSTER, MONSTER, PERCEELANALYSE, BODEMSITE, BODEMLOCATIE, EXPLOITANT, IIOA, IIOA_BESLISSING, INSTALLATIE, VERGUNNING, VERGUNNING_PROCEDURE, VERGUNNING_MASTER, BODEMCLASSIFICATIE_BE, BODEMCLASSIFICATIE_WRB, BODEMCLASSIFICATIE_EXTRA, BODEMKUNDIGEOPBOUW, BODEMDIEPTEINTERVAL, BODEMMONSTER, BODEMOBSERVATIE, BODEMOBSERVATIEPLAN, VOORAFMELDING, NULMELDING, BEMALING, INSTRUMENT, SENSOR, TERREINVINPROEF, GEOLABOPROEVEN, VOLUMEMASSA, WATERGEHALTE, SAMENDRUKKING, LABOVIN, TRIAXIAAL, GEOCORE, BOORMEESTEROPLEIDING, BOORBEDRIJF, OBSERVATIE, UNKNOWN].

compensatieData.compensaties[].instrument.objectBeheer.id

Integer

true

Technisch id.

compensatieData.compensaties[].instrument.objectBeheer.status.code

String

false

Unieke identificatie van het element.

Veld mag geen spaties bevatten.
code moet 1 tot 10 karakters zijn.

compensatieData.compensaties[].instrument.objectBeheer.status.beschrijving

String

false

Beschrijving van het element.

beschrijving moet 1 tot 50 karakters zijn.

compensatieData.compensaties[].instrument.objectBeheer.databeheerder.id

String

true

Technisch id.

compensatieData.compensaties[].instrument.objectBeheer.leesgroepen.id

String

true

Technisch id.

compensatieData.compensaties[].instrument.objectBeheer.leesgroepen.leden[].id

String

true

Technisch id.

compensatieData.compensaties[].compensatie.code

String

false

Unieke identificatie van het element.

compensatieData.compensaties[].compensatie.beschrijving

String

false

Beschrijving van het element.

compensatieData.id

Integer

true

Technisch id.

Demo 9: Instrument linken met een filter of bodemlocatie

Algemene aandachtspunten

Een instrument kan met 1 of meerdere filters en/of bodemlocaties gekoppeld worden.

  • Het instrument ID of PERMKEY moet meegegeven worden

  • Indien gekoppeld met een filter moet de FILTER permkey meegegeven worden

  • Indien gekoppeld met een bodemlocatie moet de BODEMLOCATIE permkey meegegeven worden.

Linken

Een link kan aangemaakt worden door een POST request te doen naar de server met in de body een json die de data bevat van de link.

POST /hfmetingen/instrumentlink

Path parameters

Geen parameters.

Query parameters

Geen parameters.

Voorbeeld request
POST /base/instrumentlink/ HTTP/1.1
Content-Type: application/json
Accept: application/json
Content-Length: 1179
Host: services.dov.vlaanderen.be:8080

{
  "objectType" : "FILTER",
  "instrument" : {
    "id" : null,
    "permKey" : "2021-000082",
    "domainObjectType" : null,
    "naam" : null,
    "objectBeheer" : null
  },
  "filterObjectLinkMetadataDto" : {
    "id" : null,
    "koppelnaam" : "Filter1",
    "van" : "01-04-2021 08:00:00",
    "tot" : null,
    "status" : {
      "code" : "4",
      "beschrijving" : "Publiek"
    },
    "leesgroepen" : null,
    "filter" : {
      "id" : null,
      "name" : null,
      "permKey" : "2014-000873",
      "displayName" : null,
      "opvolging" : {
        "@class" : "be.vlaanderen.dov.ocdov.domain.shared.dto.ProefStatusDto",
        "id" : null,
        "status" : null,
        "gedeeldeLeesToegangCode" : null,
        "databeheerder" : null,
        "gedeeldeLeesGroepen" : [ ],
        "statusMotivatie" : null,
        "invoerbron" : "STANDAARD",
        "aanleverdatum" : null,
        "partner" : null,
        "securityStatus" : null
      }
    },
    "ophangLengte" : 15.0,
    "referentie" : {
      "code" : "1",
      "beschrijving" : "Maaiveld"
    },
    "businessKey" : "Filter1"
  },
  "bodemObjectLinkMetadataDto" : null,
  "businessKey" : "Filter1"
}
Voorbeeld request body
POST /base/instrumentlink/ HTTP/1.1
Content-Type: application/json
Accept: application/json
Content-Length: 1179
Host: services.dov.vlaanderen.be:8080

{
  "objectType" : "FILTER",
  "instrument" : {
    "id" : null,
    "permKey" : "2021-000082",
    "domainObjectType" : null,
    "naam" : null,
    "objectBeheer" : null
  },
  "filterObjectLinkMetadataDto" : {
    "id" : null,
    "koppelnaam" : "Filter1",
    "van" : "01-04-2021 08:00:00",
    "tot" : null,
    "status" : {
      "code" : "4",
      "beschrijving" : "Publiek"
    },
    "leesgroepen" : null,
    "filter" : {
      "id" : null,
      "name" : null,
      "permKey" : "2014-000873",
      "displayName" : null,
      "opvolging" : {
        "@class" : "be.vlaanderen.dov.ocdov.domain.shared.dto.ProefStatusDto",
        "id" : null,
        "status" : null,
        "gedeeldeLeesToegangCode" : null,
        "databeheerder" : null,
        "gedeeldeLeesGroepen" : [ ],
        "statusMotivatie" : null,
        "invoerbron" : "STANDAARD",
        "aanleverdatum" : null,
        "partner" : null,
        "securityStatus" : null
      }
    },
    "ophangLengte" : 15.0,
    "referentie" : {
      "code" : "1",
      "beschrijving" : "Maaiveld"
    },
    "businessKey" : "Filter1"
  },
  "bodemObjectLinkMetadataDto" : null,
  "businessKey" : "Filter1"
}
Voorbeeld response body: succes
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1445

{
  "objectType" : "FILTER",
  "instrument" : {
    "id" : "86",
    "permKey" : "2021-000082",
    "domainObjectType" : null,
    "naam" : null,
    "objectBeheer" : {
      "id" : 87,
      "status" : {
        "code" : "4",
        "beschrijving" : "Publiek"
      },
      "databeheerder" : {
        "id" : "10",
        "kbonummer" : null,
        "ovocode" : null,
        "naam" : "dOMG"
      },
      "leesgroepen" : null
    }
  },
  "filterObjectLinkMetadataDto" : {
    "id" : 609,
    "koppelnaam" : "Filter1",
    "van" : "01-04-2021 08:00:00",
    "tot" : null,
    "status" : {
      "code" : "4",
      "beschrijving" : "Publiek"
    },
    "leesgroepen" : null,
    "filter" : {
      "id" : "882",
      "name" : null,
      "permKey" : "2014-000873",
      "displayName" : null,
      "opvolging" : {
        "@class" : "be.vlaanderen.dov.ocdov.domain.shared.dto.ProefStatusDto",
        "id" : null,
        "status" : null,
        "gedeeldeLeesToegangCode" : null,
        "databeheerder" : null,
        "gedeeldeLeesGroepen" : [ ],
        "statusMotivatie" : null,
        "invoerbron" : "STANDAARD",
        "aanleverdatum" : null,
        "partner" : null,
        "securityStatus" : null
      }
    },
    "ophangLengte" : 15.0,
    "referentie" : {
      "code" : "1",
      "beschrijving" : "Maaiveld"
    },
    "businessKey" : "Filter1"
  },
  "bodemObjectLinkMetadataDto" : null,
  "businessKey" : "Filter1"
}
Beschrijving velden in de resonse body
Path Type Optioneel Beschrijving

objectType

String

true

Moet 1 van volgende waarden zijn [BORING, DOSSIER, OPDRACHT, INTERPRETATIE, SONDERING, XML, PUT, TYPEPUT, GWLOCATIE, FILTER, FILTERGROEP, TYPEFILTER, WATERMONSTER, GRONDMONSTER, MONSTER, PERCEELANALYSE, BODEMSITE, BODEMLOCATIE, EXPLOITANT, IIOA, IIOA_BESLISSING, INSTALLATIE, VERGUNNING, VERGUNNING_PROCEDURE, VERGUNNING_MASTER, BODEMCLASSIFICATIE_BE, BODEMCLASSIFICATIE_WRB, BODEMCLASSIFICATIE_EXTRA, BODEMKUNDIGEOPBOUW, BODEMDIEPTEINTERVAL, BODEMMONSTER, BODEMOBSERVATIE, BODEMOBSERVATIEPLAN, VOORAFMELDING, NULMELDING, BEMALING, INSTRUMENT, SENSOR, TERREINVINPROEF, GEOLABOPROEVEN, VOLUMEMASSA, WATERGEHALTE, SAMENDRUKKING, LABOVIN, TRIAXIAAL, GEOCORE, BOORMEESTEROPLEIDING, BOORBEDRIJF, OBSERVATIE, UNKNOWN].

instrument.id

String

true

Technisch id.

instrument.permKey

String

true

Permanente identifier.

instrument.domainObjectType

String

true

Moet 1 van volgende waarden zijn [BORING, DOSSIER, OPDRACHT, INTERPRETATIE, SONDERING, XML, PUT, TYPEPUT, GWLOCATIE, FILTER, FILTERGROEP, TYPEFILTER, WATERMONSTER, GRONDMONSTER, MONSTER, PERCEELANALYSE, BODEMSITE, BODEMLOCATIE, EXPLOITANT, IIOA, IIOA_BESLISSING, INSTALLATIE, VERGUNNING, VERGUNNING_PROCEDURE, VERGUNNING_MASTER, BODEMCLASSIFICATIE_BE, BODEMCLASSIFICATIE_WRB, BODEMCLASSIFICATIE_EXTRA, BODEMKUNDIGEOPBOUW, BODEMDIEPTEINTERVAL, BODEMMONSTER, BODEMOBSERVATIE, BODEMOBSERVATIEPLAN, VOORAFMELDING, NULMELDING, BEMALING, INSTRUMENT, SENSOR, TERREINVINPROEF, GEOLABOPROEVEN, VOLUMEMASSA, WATERGEHALTE, SAMENDRUKKING, LABOVIN, TRIAXIAAL, GEOCORE, BOORMEESTEROPLEIDING, BOORBEDRIJF, OBSERVATIE, UNKNOWN].

instrument.objectBeheer.id

Integer

true

Technisch id.

instrument.objectBeheer.status.code

String

false

Unieke identificatie van het element.

Veld mag geen spaties bevatten.
code moet 1 tot 10 karakters zijn.

instrument.objectBeheer.status.beschrijving

String

false

Beschrijving van het element.

beschrijving moet 1 tot 50 karakters zijn.

instrument.objectBeheer.databeheerder.id

String

true

Technisch id.

instrument.objectBeheer.leesgroepen.id

String

true

Technisch id.

instrument.objectBeheer.leesgroepen.leden[].id

String

true

Technisch id.

filterObjectLinkMetadataDto.id

Integer

true

Technisch id.

filterObjectLinkMetadataDto.koppelnaam

String

true

Het veld mag niet leeg zijn.
Size must be between 0 and 255 inclusive.

filterObjectLinkMetadataDto.status.code

String

false

Unieke identificatie van het element.

Veld mag geen spaties bevatten.
code moet 1 tot 10 karakters zijn.

filterObjectLinkMetadataDto.status.beschrijving

String

false

Beschrijving van het element.

beschrijving moet 1 tot 50 karakters zijn.

filterObjectLinkMetadataDto.leesgroepen.id

String

true

Technisch id.

filterObjectLinkMetadataDto.leesgroepen.leden[].id

String

true

Technisch id.

filterObjectLinkMetadataDto.filter.id

String

true

Technisch id.

filterObjectLinkMetadataDto.filter.permKey

String

true

Permanente identifier.

filterObjectLinkMetadataDto.filter.opvolging.id

String

true

Technisch id.

filterObjectLinkMetadataDto.filter.opvolging.status.code

String

false

Unieke identificatie van het element.

Veld mag geen spaties bevatten.
code moet 1 tot 10 karakters zijn.

filterObjectLinkMetadataDto.filter.opvolging.status.beschrijving

String

false

Beschrijving van het element.

beschrijving moet 1 tot 50 karakters zijn.

filterObjectLinkMetadataDto.filter.opvolging.databeheerder.code

String

false

Unieke identificatie van het element.

filterObjectLinkMetadataDto.filter.opvolging.databeheerder.beschrijving

String

false

Beschrijving van het element.

filterObjectLinkMetadataDto.filter.opvolging.gedeeldeLeesGroepen[].id

String

true

Technisch id.

filterObjectLinkMetadataDto.filter.opvolging.gedeeldeLeesGroepen[].leden[].id

String

true

Technisch id.

filterObjectLinkMetadataDto.ophangLengte

Decimal

true

Must have at most 8 integral digits and 2 fractional digits.

filterObjectLinkMetadataDto.referentie.code

String

false

Unieke identificatie van het element.

Code moet 1 tot 10 karakters zijn.
Veld mag geen spaties bevatten.

filterObjectLinkMetadataDto.referentie.beschrijving

String

false

Beschrijving van het element.

Beschrijving moet 1 tot 50 karakters zijn.

bodemObjectLinkMetadataDto.id

Integer

true

Technisch id.

bodemObjectLinkMetadataDto.koppelnaam

String

true

Het veld mag niet leeg zijn.
Size must be between 0 and 255 inclusive.

bodemObjectLinkMetadataDto.status.code

String

false

Unieke identificatie van het element.

Veld mag geen spaties bevatten.
code moet 1 tot 10 karakters zijn.

bodemObjectLinkMetadataDto.status.beschrijving

String

false

Beschrijving van het element.

beschrijving moet 1 tot 50 karakters zijn.

bodemObjectLinkMetadataDto.leesgroepen.id

String

true

Technisch id.

bodemObjectLinkMetadataDto.leesgroepen.leden[].id

String

true

Technisch id.

bodemObjectLinkMetadataDto.bodemobject.id

String

true

Technisch id.

bodemObjectLinkMetadataDto.bodemobject.permKey

String

true

Permanente identifier.

bodemObjectLinkMetadataDto.bodemobject.opvolging.id

String

true

Technisch id.

bodemObjectLinkMetadataDto.bodemobject.opvolging.status.code

String

false

Unieke identificatie van het element.

Veld mag geen spaties bevatten.
code moet 1 tot 10 karakters zijn.

bodemObjectLinkMetadataDto.bodemobject.opvolging.status.beschrijving

String

false

Beschrijving van het element.

beschrijving moet 1 tot 50 karakters zijn.

bodemObjectLinkMetadataDto.bodemobject.opvolging.databeheerder.code

String

false

Unieke identificatie van het element.

bodemObjectLinkMetadataDto.bodemobject.opvolging.databeheerder.beschrijving

String

false

Beschrijving van het element.

bodemObjectLinkMetadataDto.bodemobject.opvolging.gedeeldeLeesGroepen[].id

String

true

Technisch id.

bodemObjectLinkMetadataDto.bodemobject.opvolging.gedeeldeLeesGroepen[].leden[].id

String

true

Technisch id.

bodemObjectLinkMetadataDto.startDiepte

Decimal

true

Must have at most 8 integral digits and 2 fractional digits.

bodemObjectLinkMetadataDto.eindDiepte

Decimal

true

Must have at most 8 integral digits and 2 fractional digits.