DTN Weather APIs

DTN Weather API's

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

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.