Introduction

A majority of services / data offered at EuRIS can also be accessed via Webservices (Open APIs). These include:

• reference data (RIS Index, network)
• fairway objects (locks, bridges, berths, terminals etc.)
• dynamic fairway information (water levels, bridge clearance, discharge etc.)
• dynamic traffic information (positions, traffic density etc.)
• transport information (routing, voyage information etc.)

The interfaces and their content are described on the Open Service Portal. Publicly available service categories can be tested without registration by clicking the „Try it out“ function button: Open Service Portal

Further documentation and developer information on the APIs including code examples can be found on the following page: API Documentation

The usage of EuRIS APIs is free of charge and much welcome. If you use our data or services incorporate the following source information in your service:

• API/Service [name of API/service] incorporated from EuRIS (eurisportal.eu)” 

Security

EuRIS APIs providing sensitive data are secured.

For permanent use of the interfaces, as well as their integration into third-party applications (e.g. by application manufacturers), you need to authenticate yourself.

EuRIS supports multiple authentication flows. It is recommended to use the Personal Access Token (PAT) system. Information on the other supported flows (e.g. OAuth v2 / OpenID Connect for machine-to-machine communication) can be found in the API Documentation (Fundamentals section).

To make use of the PAT system, you need to set up a token:

1. Log in to eurisportal.eu (top right corner)
2. Go to top right corner Username > My Account > API Tokens
3. Click Add
4. Choose a name and expiry date for your token
5. Created tokens are only shown once after creation and will not be stored in EuRIS, be sure to save them

Tokens can be valid for up to one year. Existing tokens can be revoked and their expiration tracked. You will be notified before a token expires so you can update it.