DTN Weather API's
Unique Weather Data APIs directly available Unique capabilities DTN Weather Data APIs unlock our vast weather databases, turning them into actionable insights, suitable for any business in any industry. Our Weather APIs are reliable, flexible and scalable and offer the following unique capabilities: We will work closely with you to deliver the best weather data for your business.
Our global network of weather stations, radars and satellites will ensure you have the most accurate and versatile meteorological data at your fingertips. DTN offers the following unique, out of the box, Weather Data APIs: In addition, with our help and support, you can create any additional APIs and data integrations which helps your business succesfully improve its operational processes.
USP for DTN
Unique capabilities DTN Weather Data APIs unlock our vast weather databases, turning them into actionable insights, suitable for any business in any industry. Our Weather APIs are reliable, flexible and scalable and offer the following unique capabilities: We will work closely with you to deliver the best weather data for your business. Our global network of weather stations, radars and satellites will ensure you have the most accurate and versatile meteorological data at your fingertips.
Authentication
API authentication employed by DTN for Weather APIs relies on the use of client credentials and access tokens following the process described in this section.
RECEIVING CLIENT CREDENTIALS
To be able to access APIs, customers need the following credentials:
For all Weather APIs other than the Nautical API:
- Client ID.
- Client secret.
The API credentials are provided by DTN Customer Service once a trial/contract has been agreed. Once the API credentials are created, the trial customer receives a welcome message including the relevant credentials.
REQUESTING THE ACCESS TOKEN
When you have your client credentials, request an access token from the authorization server as follows:
POST /oauth/token HTTP/1.1
Authorization: ***** HTTP basic authentication with client_id and client_secret *****
Content-Type: application/x-www-form-urlencoded; charset=utf-8
Host: auth.weather.mg
Connection: close
grant_type=client_credentials
We are supporting only POST method for obtaining access tokens.
The access token is included in the return message, encrypted with a key from the authorization service. It contains the client ID, scopes, and an expiration date.
The access token is only valid for a limited time period (currently 1 hour). Once it expires, you should request a new token.
All endpoints are secured using OAuth2 authorization protocol with data transmitted over HTTPS.
For details on how to get the necessary authorization information, see
technical documentation on Bitbucket.
USING THE ACCESS TOKEN
The HTTP GET request to the endpoints needs to provide the access token which is inserted into the Authorization HTTP Header.
More information about the Jason Web Token (JWT) can be found
here.
The Authorization HTTP Header, with the provided authorization token, should look as follows:
Authorization: Bearer {Encrypted Token}.
The Authorization token contains the allowed scopes for the client. For example, point-observation is the scope that allows the client to request the Point Observation API.
APIs Available Now
Point Forecast
DTN Point Forecast API delivers high quality weather forecasts via
https://point-forecast.weather.mg/forecast/hourly.
The API can be requested for weather stations, or relevant locations / assets / cities.
> Find out more
Point Observations
DTN Point Observation API delivers high-quality weather observation data via
https://point-observation.weather.mg.
The API can be requested for weather stations, or relevant locations / cities.
> Find out more
Radar Precipitation Forecast
DTN Radar Precipitation Forecast API provides time series with short-term precipitation forecasts, based on radar data via
https://precipitation-forecast.weather.mg/search
A forecast can be requested that is either representative of a specific location, or an area smaller than 40x40km (via the bounding box).
> Find out more
Release notes
Release number | Description | Link |
---|---|---|
1.5 | Adding parameters to Point Observation Service and DTN announcement. | Release 1.5 |
1.4 | Release of Radar Precipitation Forecast API and Public Status Page. | Release 1.4 |
1.3 | New main endpoint for Point Forecast Service. Additional parameters with gap filling in Point Observation API. | Release 1.3 |
1.2 | API environment now fully in AWS. Also professionalized usage monitoring and trial handling. | Release 1.2 |
1.1 | Gap filling with pseudo-observations now available for key parameters. Also additional radiation parameters now available. | Release 1.1 |
Requesting Access
DTN Weather APIs are available to authenticated users only.
To obtain the necessary authorization, contact us or reach out to your DTN
Sales Representative.