A note on version numbers: As of the final state of this specification, the version number has changed from 2.0 to 2.0.1, to harmonize the version numbers between the regular DD-API and the DD-OPER-API.
This specification describes the Digital Delta API Version 2.0.1 (DD-API 2.0.1). It is meant for both implementers and consumers of the Digital Delta API specifications.
Version 2.0.1 of the DD-API builds on the foundation as specified in version 1.0.
See the Digital Delta project for background information.
The changes in version 2.0.1 compared to 1.0 can be summarized as:
- Renaming of some attributes, e.g. for consistency reasons, or to clarify the content of the attribute
- Adjusting some resource object types in the response in order to let them adhere better to standards. For instance, the Location objects now is a GeoJSON object) and the paging information has been re-arranged according the DSO API guidelines.
- Adding attributes to the Timeseries object that facilitate the definition of computation results and ensemble runs.
- Adding interval information to the values in a Timeseries
- Adding the concept of aspect sets, a mechanism to group related time series, e.g. the minimum, maximum and average of a measured quantity, or the direction and amplitude of wave field.
Due to the nature of the changes, version 2.0.1 is not backwards compatible with version 1.0.
The status of this specification is final.
The specification is written in RAML 1.0, a 'language' to define REST (REpresentational State Transfer) service.
It is a specification. This means that there is no full implementation of this specification available in this repository. There are, however, result samples available. Some helper classes in the C# programming language are available in the Wiki.
To read the RAML specification, some tools are recommended. Some tools are also capable of generating documentation, or code skeletons for both consumers and implementers.
The HTML specifications can also be used and may be easier to read.
The easiest way to get the specification is to download the generated HTML files. To be able to use the RAML files, please consult the tools section. Knowledge of the RAML language is then recommended.
Version 2.0. includes two specifications. The DD-API 2.0.1 of the specification is the 'general purpose' specification, with Url's that facilitate both searching for and retrieving data. Hence it both for discovery and for getting data.
The Operational extension "DD-OPER-API" is an extension developed for/by Rijkswaterstaat, designed to retrieve data using a fixed strict Url-path. It only differs from the generic version in the Url-syntax. The DD-OPER-API does not support discovery.
The changes between version 1.0 and 2.0.1 are described here.
The Current Implementations contains the most recent list of implementations of the Digital Delta Specifications.