Smart Data Solutions Data Api

<back to all web services

WeatherData

Weatherdata provided by KNMI. Data is free to use as long as the source of the data is provided. For more information: http://www.knmi.nl

The following routes are available for this service:
GET/weatherdata/{WeatherStationId}/{Aggregation}/{DateFrom}/{DateTo}Get weather data for chosen weatherstation for a specific period
WeatherData Parameters:
NameParameterData TypeRequiredDescription
WeatherStationIdpathIntYesWeatherStation Id to get weather data for
AggregationpathEnumYesAggregation level: Month/Day/Hour/None
DateFrompathDate (yyyy-MM-dd)YesGet weatherdata from date
DateTopathDate (yyyy-MM-ddYesGet weatherdata to date
CacheKeyquerystringNo
Generic Parameters:
NameParameterData TypeRequiredDescription
ApiKeyformStringYesApi-key. Used to provide credentials to the api. Can also be provided through the request headers with key: X-API-KEY
OnlyPayloadformBooleanNoNormally the result of the request is put inside a resultobject with some status information about the request. If you want the output as csv this outer object can be irritating. Default value: FALSE
ShowRequestformBooleanNoShow the request as interpreted by the api. Useful to see how filters / dates are parsed. If no value us provided, the default value is: FALSE
DateTimeFormatformEnumNoFormat all DateTime in the response object. If used in browser, sometimes ISO8601 is not correctly transformed. Enum options: ISO8601 (DEFAULT), UTC, NL, NLOffset, Unix, UnixMillis

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /xml/oneway/WeatherData HTTP/1.1 
Host: data.smartdatasolutions.nl 
Content-Type: application/xml
Content-Length: length

<WeatherData xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SDS.Backend.APIs.DataApi.DTO.Request">
  <ApiKey>String</ApiKey>
  <DateTimeFormat>ISO8601</DateTimeFormat>
  <OnlyPayload>false</OnlyPayload>
  <ShowRequest>false</ShowRequest>
  <Aggregation>None</Aggregation>
  <DateFrom>0001-01-01T00:00:00</DateFrom>
  <DateTo>0001-01-01T00:00:00</DateTo>
  <WeatherStationId>0</WeatherStationId>
</WeatherData>