W
WIWB API 2.0
Terug naar Home
1. Introductie

Aan de slag

Welkom bij de WIWB (Weer Informatie WaterBeheer) API 2.0 documentatie. Deze handleiding helpt je om aan de slag te gaan met het integreren van weergegevens in je waterbeheer toepassingen.

De WIWB API 2.0 biedt toegang tot een breed scala aan weerinformatie voor waterbeheer. Deze data wordt continu opgehaald bij 4 verschillende dataleveranciers:

  1. KNMI (Koninklijk Nederlands Meteorologisch Instituut)
  2. Satdata (Satellietdata voor landbouw en waterbeheer)
  3. ECMWF (European Centre for Medium-Range Weather Forecasts)
  4. HKV (dataleverancier voor Meteobase)

Vereisten

Voordat je begint, zorg ervoor dat je hebt:

  • API credentials (client_id en client_secret, vraag deze aan via onze registratiepagina)
  • Basiskennis van RESTful API's
  • Een programmeertaal of tool die HTTP-verzoeken kan maken

Snel aan de slag

Stap 1: Verkrijg je API credentials

Bezoek onze registratiepagina om API credentials (client_id en client_secret) aan te vragen. Je ontvangt deze via e-mail binnen 1-2 werkdagen.

Stap 2: Verkrijg een access token

Zodra je je API credentials hebt, kun je een access token aanvragen:

curl -X POST "https://api.wiwb.nl/auth/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -H "Accept: application/json" \
  -d "client_id=JOUW_CLIENT_ID&client_secret=JOUW_CLIENT_SECRET&grant_type=client_credentials"

Note: Vervang https://api.wiwb.nl met de actuele API URL die je van ons hebt ontvangen.

Stap 3: Verken beschikbare eindpunten

De WIWB API biedt verschillende eindpunten voor verschillende soorten weergegevens:

Metadata endpoints:

  • /api/entity/datasources/get - De databronnen die worden ondersteund
  • /api/entity/datasourcevariables/get - De variabelen die worden ondersteund
  • /api/entity/locations/get - Alle locaties
  • /api/entity/timeseriesinformations/get - Informatie over de tijdreeksen
  • /api/entity/griddefinitions/get - De definities van de rasters
  • /api/entity/projections/get - De ondersteunde projecties

Data endpoints: Water gerelateerde data is onderverdeeld in zogenaamde StructureTypes: timeseries, grids, modelgrids, ensemblegrids, ensembletimeseries. Deze worden aangeroepen via:

  • /api/timeseries/get - Tijdreeksgegevens
  • /api/grids/get - Rastergegevens
  • /api/modelgrids/get - Modelrastergegevens

Responsformaat

Alle API-responsen zijn in JSON-formaat, bijv:

{
	"Data": [
		{
			"CalculationType": "Average",
			"Data": [
				{
					"DateTime": "20250813111000",
					"Availability": 0,
					"Value": -9999
				},
				{
					"DateTime": "20250813112000",
					"Availability": 1,
					"Value": 138.4
				}
			],
			"DataSourceVariableId": 2457,
			"DataType": "Single",
			"EndDate": "20250813112000",
			"Interval": {
				"Type": "Minutes",
				"Value": 10
			},
			"IsCumulative": false,
			"IsSlidingWindow": false,
			"IsTotal": false,
			"LocationCode": "06204",
			"LocationIdentifier": "Knmi.Synops#06204",
			"NoDataValue": -9999,
			"SlideInterval": {
				"Type": "Undefined",
				"Value": 0
			},
			"StartDate": "20250813110000",
			"TimeZoneOffset": "+0000",
			"UseQuality": false,
			"VariableCode": "WindDirection",
			"Debug": {
				"Urls": [
					"https://lizard.twinn.io/api/v4/timeseries/458e429d-2716-461f-8d9d-a6c46e9de0ae/aggregates?closed=right&end=2025-08-13T11%3A20%3A00.000Z&fields=last_timestamp%2Clast&label=right&start=2025-08-13T11%3A00%3A00.000Z&window=10minutes"
				]
			}
		}
	],
	"Meta": {
		"DataSourceVariables": {
			"2457": {
				"DataSourceVariableId": 2457,
				"VariableCode": "WindDirection",
				"DataSourceCode": "Knmi.AwsTenMinutes",
				"UnitCode": "deg",
				"Name": "Wind Direction",
				"Code": "dd",
				"Description": null,
				"DataType": "Single",
				"NoDataValue": null,
				"MathematicalType": "NotSummable",
				"MeasurementType": "Period",
				"State": 1,
				"IsCumulative": false
			}
		},
		"Locations": {
			"Knmi.Synops#06204": {
				"Identifier": "Knmi.Synops#06204",
				"LocationId": 2340,
				"Code": "06204",
				"Name": "K14-FA-1C",
				"X": 3.62778,
				"Y": 53.26944,
				"Z": 41,
				"Tags": {},
				"ProjectionId": 3
			}
		},
		"Projections": {
			"3": {
				"ProjectionId": 3,
				"Name": "WGS84",
				"Epsg": 4326,
				"ProjectionString": "+proj=longlat +ellps=WGS84 +datum=WGS84 +no_defs"
			}
		},
		"Units": {
			"deg": {
				"Code": "deg",
				"Name": "degrees"
			}
		},
		"Variables": {
			"WindDirection": {
				"Code": "WindDirection",
				"Description": null,
				"Name": "Wind Direction",
				"State": 1,
				"UnitCode": "deg"
			}
		}
	},
	"StructureType": "TimeSeries"
}}

Postman voorbeeldverzoeken

We hebben een complete Postman collectie beschikbaar met alle API voorbeelden. Dit maakt het testen en integreren van de API veel eenvoudiger.

→ Download de Postman collectie en bekijk voorbeelden

De collectie bevat:

  • Authenticatie voorbeelden
  • Grid data opvragen (radar, weather models)
  • Tijdreeks data voorbeelden
  • Metadata endpoints
  • Verschillende export formaten

Volgende stappen

Volgende: Authenticatie