Category:EMD-API

From Wiki-WindPRO
Jump to navigation Jump to search

Intoduction

Historically, windPRO users have benefitted from easy access to the EMD online-databases – data which have been specifically developed and distributed for renewable energy purposes. With the REST (Representational State Transfer) based API’s in the EMD-API service, it is now possible to connect your machine driven workflows, internal tools and services directly to more than 1Pb of high-quality climate data and other services at EMD. This page provides a brief overview on how-to access the EMD online-services through a REST-based API-access based on the Open API Standard. Resources for the OpenAPI standard and the data model are here:

Please note: This introduction is rather technical, and aimed at programmers, modellers or analysts who are working with machine-driven interfaces and workflows. Also note, that we provide a number of python (jupyter notebook) samples to get you kick-started in using our API-services and to integrate towards your own services and tools.

Get Access or Get Help

  • Access: Contact the emd-sales department to obtain access: sales@emd.dk.
  • Help: Contact the EMD support hotline: support@emd.dk.

Authentication

Database-access is via an API-key approach which authenticates against a server-whitelist. Dataset users provide their login credentials (user-name and serial-key) – and the server respondswith a API-key that is then used for the authentication within the data-service API's. The API-key is personal and is never to be shared.

URL's for API-Access and Documentation

Data and services are accessed from the following general URL: https://api.emd.dk. Individual data and service API's are available from other wiki-pages (see also the pages below).

License Conditions

At this time of writing (November 2020), this service is in beta-release. The current licencing conditions - for the beta-API services - are as follows:

API access is currently provided as an addition to the services provided for our windPRO and energyPRO users. As such, the general EMD license conditions apply - see pdf-here. For our API-users, the license conditions are amended with the following:

Conditions for EMDAPI-Users:
API access to EMD online-databases are restricted to users who have been granted or have purchased the EMDAPI-access subscription. API-users are granted a license to use the data, combine the data with other products, copy the data and distribute the data in a modified form - also as a part of a commercial re-licensing. The data can be used as a part of an application or service. The following restrictions apply: Data downloads are unlimited – however a fair use policy apply. Multiple, simultaneous download-streams are not allowed. It is not allowed to re-sell or re-distribute the data in an unmodified form (where the original numerical values in the dataset are left unmodified). EMD must be notified of and approve in writing any commercial data-service offerings with re-licensing aimed at 3rd-parties. API-subscribers must clearly acknowledge EMD and its data providers as the source of data in any private or public disseminations: For details on how-to provide the attribution see the individual climate-dataset documentation pages at the online-data wiki: https://help.emd.dk/mediawiki/

The license conditions will be updated before final release of this service.