WIWB API 2.0 - Weer Informatie Waterbeheer

Deze pagina bevat praktische voorbeelden van API calls die je direct kunt kopiëren en gebruiken. Voor een complete Postman collectie, download het JSON bestand.

Note: In de onderstaande voorbeelden wordt https://api.wiwb.nl gebruikt als placeholder. Vervang dit met de actuele API URL die je van ons hebt ontvangen.

Authenticatie

Token ophalen

Gebruik deze call om een access token op te halen. Dit token is nodig voor alle andere API calls.

Endpoint: POST https://api.wiwb.nl/auth/token

Headers:

Content-Type: application/x-www-form-urlencoded
Accept: application/json

Body (URL-encoded):

client_id=YOUR_CLIENT_ID
client_secret=YOUR_CLIENT_SECRET
grant_type=client_credentials

cURL voorbeeld:

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

Data Streaming - Grids

De grid data wordt opgehaald via een POST request naar /api/grids/get met een JSON body die specificeert welke data je wilt ophalen.

KNMI International Radar Composite - Neerslag

Endpoint: POST https://api.wiwb.nl/api/grids/get

Headers:

Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json
Accept: application/json

Uurlijkse neerslag (P_hour) - Punt data

Body (JSON):

{
    "Readers": [
        {
            "DataSourceCode": "Knmi.International.Radar.Composite",
            "Settings": {
                "StartDate": "20250828130000",
                "EndDate": "20250828140000",
                "VariableCodes": ["P_hour"],
                "Extent": {
                    "Xll": 154404,
                    "Yll": 536315,
                    "Xur": 154404,
                    "Yur": 536315,
                    "SpatialReference": {
                        "Epsg": 28992
                    }
                },
                "Interval": {
                    "Type": "Hours",
                    "Value": 1
                }
            }
        }
    ],
    "Exporter": {
        "DataFormatCode": "json"
    }
}

cURL voorbeeld:

curl -X POST "https://api.wiwb.nl/api/grids/get" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "Readers": [{
        "DataSourceCode": "Knmi.International.Radar.Composite",
        "Settings": {
            "StartDate": "20250828130000",
            "EndDate": "20250828140000",
            "VariableCodes": ["P_hour"],
            "Extent": {
                "Xll": 154404,
                "Yll": 536315,
                "Xur": 154404,
                "Yur": 536315,
                "SpatialReference": {"Epsg": 28992}
            },
            "Interval": {"Type": "Hours", "Value": 1}
        }
    }],
    "Exporter": {"DataFormatCode": "json"}
}'

Dagelijkse neerslag (P_day) - Gebied data

Body (JSON):

{
    "Readers": [
        {
            "DataSourceCode": "Knmi.International.Radar.Composite",
            "Settings": {
                "StartDate": "20250828000000",
                "EndDate": "20250829000000",
                "VariableCodes": ["P_day"],
                "Extent": {
                    "Xll": 96880,
                    "Yll": 420354,
                    "Xur": 111693,
                    "Yur": 429373,
                    "SpatialReference": {
                        "Epsg": 28992
                    }
                },
                "Interval": {
                    "Type": "Days",
                    "Value": 1
                }
            }
        }
    ],
    "Exporter": {
        "DataFormatCode": "json"
    }
}

Export Formaten

Je kunt de data in verschillende formaten exporteren door de DataFormatCode aan te passen:

"json" - JSON formaat
"netcdf4.cf1p6" - NetCDF formaat
"geotiff" - GeoTIFF formaat

Parameters Uitleg

Datum/Tijd Formaat

StartDate/EndDate: Gebruik het formaat YYYYMMDDHHmmss (bijvoorbeeld: 20250828130000 voor 28 augustus 2025, 13:00:00)

Ruimtelijke Extent

Xll, Yll: Linker onderhoek coördinaten
Xur, Yur: Rechter bovenhoek coördinaten
Epsg: Spatial reference system (28992 voor Rijksdriehoek)

Voor een enkel punt, gebruik dezelfde coördinaten voor ll (lower left) en ur (upper right).

Interval

Type: "Hours", "Days", "Minutes" etc.
Value: Numerieke waarde voor het interval

Data Bronnen

Beschikbare databronnen:

Knmi.International.Radar.Composite - Radar composiet data
Knmi.Harmonie.43 - Harmonie weermodel
Knmi.AwsTenMinutes - AWS 10-minuten metingen

Tips voor gebruik

Authenticatie: Bewaar je access token veilig en vernieuw deze regelmatig
Datum formaat: Gebruik altijd het formaat YYYYMMDDHHmmss voor datums
Coördinaten: Gebruik Rijksdriehoek coördinaten (EPSG:28992) voor Nederland
Error handling: Implementeer proper error handling voor network fouten en API errors
Data formaat: Kies het juiste export formaat voor je toepassing

Postman Collectie

Voor een complete set van alle beschikbare endpoints en voorbeelden, download de Postman collectie JSON en importeer deze in Postman.

Importeren in Postman:

Open Postman
Klik op "Import"
Upload het JSON bestand
Vul je credentials in bij de authenticatie request
Voer eerst de authenticatie uit om een token te krijgen
De token wordt automatisch opgeslagen en gebruikt voor volgende requests

API Voorbeelden