Úvod

K väčšine služieb / údajov poskytovaných systémom EuRIS je možné pristupovať aj prostredníctvom webových služieb (Open API). Tieto zahŕňajú:

  • referenčné údaje (RIS Index, sieť vodných ciest)
  • objekty na vodnej ceste (plavebné komory, mosty, výväziská, terminály, atď.)
  • dynamické informácie o vodnej ceste (vodné stavy, podjazdné výšky mostov, prietoky, atď.)
  • dynamické informácie o premávke (polohy plavidiel, hustota premávky, atď.)
  • dopravné informácie (trasy, informácie o plavbe, atď.)

Rozhrania a ich obsah sú popísané na Open Service Portal. Verejne dostupné služby si môžete vyskúšať bez registrácie kliknutím na tlačidlo „Try it out“: Open Service Portal vrátane dokumentácie

Ďalšia dokumentácia a informácie pre vývojárov o API, vrátane príkladov kódu,  nájdete na nasledujúcej stránke: Dokumentácia k API.

Používanie EuRIS API je bezplatné a veľmi vítané. Ak používate naše údaje alebo služby, uveďte vo vašej službe nasledujúcu informáciu o zdroji:

  • API/Služba [názov API/služby] integrovaná z EuRIS (eurisportal.eu)

Bezpečnosť

API EuRIS, poskytujúce citlivé údaje, sú zabezpečené.

Ak chcete rozhrania využívať natrvalo a integrovať s aplikáciami tretích strán (napr. vývojár aplikácie), je potrebné splniť nasledujúce požiadavky:

Klient musí mať platný token OauthV2. EuRIS podporuje autentifikáciu prostredníctvom OAUTH v2/Open ID connect. Je integrovaný identifikačný server a môže byť použitý pre rôzne toky autentifikácie (pozrite: https://identityserver4.readthedocs.io/en/latest/intro/big_picture.html).

Ak chcete využívať chránené služby EuRIS, musíte mať autorizovaný účet. Používateľ tiež musí mať potrebné OAuth V2 klientske prihlasovacie údaje pre komunikáciu stroj - stroj. Autentifikačný proces predpokladá, že klientsky kód si vyžiada potrebné tokeny s použitím poskytnutých klientskych prihlasovacích údajov. Bearer token sa využíva v ďalšej komunikácii webovej služby. 

Ak chcete získať požadované klientske prihlasovacie údaje, pošlite nám požiadavku prostredníctvom kontaktného formulára na helpdesk, pričom uveďte nasledujúce informácie:

  • Meno žiadateľa (vrátane kontaktnej osoby spoločnosti)
  • Spoločnosť / súkromná osoba
  • Adresa
  • Účel použitia
  • Požadované rozhrania / údaje

Po úspešnom preverení požiadavky zodpovedný správca EuRIS poskytne požadované informácie, ktoré umožnia neobmedzené využívanie požadovaných rozhraní.

Prečítajte si viac...