OpenAPI / Otvorené API - plánované a realizované aktivity Slovensko.Digital

Slovensko.Digital sa systematicky venuje téme OpenAPI / Otvorené API. Cieľom je poukázať na dôležitosť danej témy, jej potenciál a byť nápomocný pri vzniku potrebných dokumentov, či už strategických alebo konkrétnych návodov, odporúčaní a postupov.

V rámci toho fóra budeme zdielať a informovať o aktivitách, výstupoch a pod., ktoré sme ako S.D zrealizovali, alebo pripomienkovali, navrhovali alebo sme sa na nich zúčastnili. Zároveň by sme uvítali spätnú reakciu, podnety v rámci témy OpenAPI. Teda ak niekoho zaujíma téma OpenAPI, tak toto fórum by mu malo poskytovať komplexný pohľad na danú tému za stranu S.D.

Na úvod zdieľame jednoduchý prehľad tém, oblastí a výstupov, ktorými sa už zaoberáme / plánujeme zaoberať v rámci témy OpenAPI. Základ definovania scopeu tvorili záväzky a plány vyplývajúce z dokumentov ako je napr. NKIVS, výstupy pracovných skupín na ÚPVII a pod. Prehľad je dostupný na tomto linku https://docs.google.com/spreadsheets/d/1fJpV4EeY_saoyxufwSOHSZol1REoZjQt8NpfeslZq3I/edit?usp=sharing

V krátkom čase pribudnú aj samotné rozpracované dokumenty. Cieľom je získanie spätnej väzby.

S týmto fórom súvisia ďalšie fóra, kde sa riešia špecifické výstupy v rámci témy OpenAPI. Snaha bude ich prelinkovávať.

Otvorený list “Za otvorené API”

Identifikované prioritné OpenAPI

Plán stretnutí s OVM k otváraniu API

1 Like

Planovane stretnutia k OpenAPI v ramci oslovenych OVM:

Socialna poistovna - 9.11.2018 - zrealizovane
VSZP - 14.11.2018 - zrealizovane
Statisticky urad SR - 20.11.2018 - zrealizovane
Financna sprava SR - 20.11.2018 - zrealizovane

…temu OpenAPI sa snazime riesit komplexne, nielen technicky a s OVM, ktore sme oslovili otvorenym listom…

…nizsie uvadzam zapis zo stretnutia (26.10.2018) v Nases k teme OpenAPI, ktore sme ako S.D iniciovali, nakolko sa teme OpenAPI venujeme systematickejsie a povazujeme za vhodne sa vzajomne koordinovat v aktivitach…

…islo o uvodne stretnutie, ktoreho sa zucastnili S.D, Nases a aj zastupca UPVII…riesilo sa viacero tem ako je napr. uprava legislativy, aby pouzitie OpenAPI bolo pre pouzivatelov komfortne, riesili sa zaklade technicke otazky k API GateWay, publikovanie pilotnych sluzieb do API GW a pod…

…ocenujeme moznost osobneho a spolocneho strenutia s Nases a UPVII v danej teme…zaroven verime, ze tieto stretnutia budu pokracovat v parcialnych temach OpenAPI…

zapis:

1. zakon o eGOV a riesenie OpenAPI

  • Slovensko.Digital a Nases si ujasnili pohlad na navrhovanu upravu zakona
  • Slovensko.Digital prednieslo, co mu v navrhu upravy chyba, aby tema OpenAPI bola z procesno-technickej roviny riesena komplexne
  • Slovensko.Digital rozporuje casovy termin navrhnuty v uprave zakona
  • Nases doriesi textaciu navrhovanej upravy zakona s UPVII

2. API GW - Runtime API GW

  • Slovensko.Digital posle strucny prehlad planovanych vystupov v ramci temy OpenAPI - S.D zrealizuje este tento tyzden
  • Nases pripravi harmonogram pre Runtime API GW + full API GW - dohodnuty termin na buduci tyzden
  • Nases pripravuje DFS k Runtime API GW - Nases si interne prejde moznosti sptistupnenia informacii/DFS pre Runtime API GW pre Slovensko.Digital

3. Pilotne API v ramci Runtime GW

  • Nases spristupni Slovensko.Digital navrh pilotnych sluzieb, ktore planuje publikovat v ramci Runtime API GW
  • je mozne doplnit/menit scope pilotnych sluzieb

4. Administrativne kapacity na riesenie OpenAPI

  • Nases nema v kompetencii riesit manazment API, ktore by mali byt spristupnene vo forme OpenAPI
  • gestorom tejto aktivity by mal byt asi UPVII

Za Slovensko.Digital navrhujeme buduci tyzden zrealizovat stretnutie/workshop k najma k bodu 2 a pripadne aj 3. Predmetom stretnuti by malo byt:

  • harmonogram pre Runtime API GW + full API GW
  • spristupnenie/prezentacia DFS k Runtime API GW
  • spristupenie/prezentacia dokumentov vytvorenych Slovensko.Digital k API GW a pohlad Slovensko.Digital na klucove funkcionality API GW + autentifikacia a autorizacia v ramci OpenAPI
  • vymedzenie aktivit, ktore budu pokryte v ramci Runtime API GW a aktivit, ktore musia OVM robit na svojej strane a za svoje financne prostriedky
  • debata o harmonograme a planovanom rozsahu (DFS) Runtime API GW

Za Slovensko. Digital navrhujeme 8.11.2018 doobeda. Osobne stretnutie v danom termine navrhujeme z dovodu, ze zaciname realizovat stretnutia s jednotlivymi OVM a chceme im na uvodnom stretnuti podavat korektne informacie o planovanych krokoch.

v ramci prveho postu v tomto fore som doplnil link na Plan stretnuti s OVM k otvaraniu API

dna 9.11. sme absolvovali stretnutie so Socialnou poistovnou v zmysle planu stretnuti…bolo to fajn stretnutie…taky uvod do problematiky

…kratky zapis…

Socialna poistovna, 9.11.2018

Ulohy/dalsie kroky:

1. Socialna poistovna posle statistiky za rok 2018 jednotlivych podani, ktore maju fyzicke a pravnicke osoby povinnost realizovat v strukture:

  • nazov agendy / nazov podania
  • jej periodicita (napr. mesacna, rocna, polrocna, …)
  • jej pocetnost k jednotke periodicity (napr. 200 000 podani/mesiac, …)

2. Zrealizovanie osobneho technickejsieho stretnutia s predmetom:

  • specifikacie scenaru zelaneho stavu - scenar pripravi Slovensko.Digital,
  • prezentacie/priblizenia architektury a technologii ISSZ zamerany najma - pripravi Socialna poistovna:
  • sposob prenosu dat medzi frontendom a backendom (pouzite technologie, standardy a pod.)

  • technicke priblizenie validacii predkladanych formularov v ramci ISSZ (implementacia kontroly, moznost jej vytiahnutia do samostatneho rozhrania, …)

  • technicke priblizenie ActiveDirectory

  • prezentacie/priblizenia napojenia agendovych IS na elektronicku schranku cez eGov konektor v ramci Socialnej poistovne

  • identifikacie problemov, ktore vypadnu z vyssie uvedenych odrazok

Bod 1 by bolo super, keby sa vam podarilo poslat este tento tyzden.

Bod 2 navrhujeme dalsie stretnutie koncom buduceho tyzdna, napr piatok 23.11. opat o 10:00. Pripadne mozme aj iny termin.

29.11.2018 sme mali stretnutie s UPVII k pripravovanej Studii uskutocnitelnosti na API GateWay ako centralny prvok referencnej architektury eGOV v SR…UPVII prislubil, ze prvu pracovnu verziu studie zverejni na MetaIS…studia je uz zverejnena https://metais.finance.gov.sk/studia/detail/ed6146af-477e-0052-d178-cc75c5dd7876?tab=documents

za S.D sme prislubili, ze prvu reakciu k studii dame v tomto tyzdni, t.j. od 3.12. do 7.12.

davam do pozornosti aj pre @ITAS

Vďaka, informoval som o tom prezidenta ITAS.
Juraj

…je dobre, ze existuje moznost SU vidiet ovela skor a viest dialog s vlastnikom SU…za S.D sme poslali zatial koncepcne pripomienky/navrhy/postrehy Koncepcne pripomienky_API GW.docx (15.9 KB) …podla dohody by malo nasledovat stretnutie, kde si nasu reakciu prejdeme…

Zapisy z jednotlivych stretnuti s OVM:

Socialna poistovna - zverejnene ako post - OpenAPI / Otvorené API - plánované a realizované aktivity Slovensko.Digital - #7 by peter_k

VSZP Zapis_VSZP_ulohy_poznamky_final.docx (14.2 KB)

Statisticky urad SR Zapis_SU_ulohy_poznamky_final.docx (12.5 KB)

Financna sprava Zapis_FS_ulohy_poznamky_final.docx (16.6 KB)

doplneny zapis zo stretnutia na Finacnej sprave

Boli sme poziadani zo strany UPVII o sucinnosti pri vydefinovani sluzieb UPVS, ktore by mali byt publikovane do API GW pre tretie strany. Tu prikladame dokument Sluzby UPVS_navrh pilotnych sluzieb.docx (7.4 KB)
v ktorom su za S.D identifikovane existujuce ale aj nove sluzby, potrebne pre riesenie end2end pouzivatelskych scenarov. Autorom zoznamu je @jsuchal

Ak niekto ma napad na dalsie sluzby UPVS, ktore by bolo fajn publikovat ako otvorene API pouzitelne tretimi stranami, tak kludne navrhy piste do tohto vlakna a s kratkym odovodnenim, aby sa lahsie chapal kontext.

Dik

2 Likes

Ja len dodám, že na časti týchto služieb (podanie plus prihlasovanie cez eid) už dnes robíme a budú publikované ako opensource komponent v Q1 2019. Komplet s dokumentáciou a postupom ako zriadiť integráciu v NASES. Je možné, že ďalšie api pôjdu v závese ak sa nájde sponzor vývoja. Zaujemci sú.

2 Likes

vypublikovanie datasetu schránok právnických osôb a OVM minimálne v rozsahu:

  • ID schránky
  • IČO
  • názov
  • adresa sídla (pre listinné doručovanie)
    NASES by mal dataset aktualizovať a synchronizovať s RPO.

Cieľ je, aby OVM pri zasielaní právnickej osobe (alebo naopak) vedel ľahko zisteiť potrebné údaje.

Na toto by mala sluzit GetEdeskInfo2 sluzba na UPVS. Ale predpokladam, ze na nejaky velmi rychly autocomplete alebo tak mozeme zabudnut. Tuto sluzbu by mozno stalo za to vystavit von cez open api tiez.

1 Like

A post was split to a new topic: Voľné pracovné miesta ako Open Data

Prikladam reakciu UPVII na koncepcne pripomienky S.D k SU SD_Koncepcne pripomienky_API GW_Odpoved_v04.docx (22.1 KB)

Nasledne sme 18.12.2018 mali osobne stretnutie, kde sme si presli za kazdu stranu vnimanie API GW, jeho casti/modulov a ich priority a moznosti nakupu/implementacie, otvoreni urcitych tem v pracovnych skupinach, atd. Zaroven sme za S.D prislubili, ze v prvom januarovom tyzdni posleme dalsiu reackiu na SU. UPVII sa zaviazal poskytnut aktualnu verziu SU.

1 Like

V zmysle dohody s UPVII nam bola poskytnuta nova verzia SU k API GW SU OPII API_GW_v1.4.docx (950 KB) co ocenujeme a sme radi, ze sa vedie dialog s vybranym externym prostredim pocas vzniku SU.

Cez vikend sme v zmsle dohody s UPVII zaslali nase agregovane najdolezitejsie pripomienky Pripomienky_API GW.rtf (523.7 KB) Pripomienky vychadzali z jednotlivych komentov a postrehov priamo v ramci novej verzie SU SU OPII API_GW_v1.4_pripo SD.docx (1.2 MB) Aj tuto SU s pripomienkami sme poskytli UPVII, aby malo k dispozicii kompletnu reakciu S.D s menej dolezitymi pripomeinkami, podla nasho nazoru idenzifikovanymi nepresnostami, a pod.

CBA sme nepripomienkovali, nakolko len v piatok 4.1.2019 sme ziskali jej novsiu verziu. Zaroven sme poziadali UPVII o info, ze ci ide o verziu, ktora je uz odobrena UHP a pod., aby sme zbytocne nepalili kapacity. Na zaklade nasich pripomienok by sme radi videli videli CBA, ktore by porovnavala viacero aletarnativ sucasne…tieto zavery si myslim su jasne z dokumentu Pripomienky_API GW

UPVII sme pripomenuli, ze by bolo vhodne zvolat PS, aby sa v ramci nej prerokovali poziadavky:

  • monetizacie otvorenych API,
  • poskytovania API GW ako PaaS,

ktore sa objavuju v SU a myslime si, ze su hodne sirsej debaty a deklarovania realnych poziadaviek.

K pripomienkam sme sa snazili pristupit konstruktivne a aby sme podporili vahu alternativy budovania riesenia nad existujucimi produktami na trhu, tak @jsuchal oslovil vyrobcov produktov Kong a Tyk a ziskal od nich cenove ponuky, ktore sme zahrnuli do pripomienok (velke dik Jano). Vyrobcovia pre dalsi dialog by uz radi hovorili so statom/relevantnym subjektom ku konkretnym cenovym ponukam, zlavam a pod.

p.s. @ITAS mohlo by vas zaujimat

…len pre info…zistujeme ceny produktov na trhu vhodnych pre riesenie API GW…aktualne mame cenove ponuky na Kong, Tyk (tieto su zahrnute v dokumente Pripomienky_API GW a teda boli distribuovane aj UPVII)…cakame na cenovu ponuku este k produktu APIgee…

…k studii uskutocnitelnosti k API GW UPVII vyhlasilo oficialne pripomienkove konanie…tu je par dolezitych info:

ÚPVII - Centrálna API manažment platforma (API GateWay)

Web:

https://www.vicepremier.gov.sk/aktuality/informatizacia/oznam-verejne-pripomienkovanie-studie-uskutocnitelnosti-centralna-api-manazment-platforma/index.html

MetaIS dokumenty:

https://metais.finance.gov.sk/studia/detail/ed6146af-477e-0052-d178-cc75c5dd7876?tab=documents

Termín na pripomienky: 21.1.2019 do 16:00

Emailový kontakt na pripomienky: jan.backo@vicepremier.gov.sk

Termín verejného prerokovania štúdie: 23. januára 2019 o 13:00 hod. v priestoroch Úradu podpredsedu vlády SR pre investície a informatizáciu, Westend, Dúbravská cesta 4, 9. poschodie

Termín nahlásenia účasti na prerokovaní: 21.1.2019 do 16:00

Emailový kontakt na nahlásene účasti: pozvanky@vicepremier.gov.sk

…mam info, ze dnes, zajtra by mohla byt publikovana aj novsia verzia studie na MetaIS…

…vcera vecer nam UPVII poskytlo najnovsiu verziu studie SU OPII API_GW_v1.10.docx (1.2 MB)
a CBA CBA_OPEN_API_Variant_80-20 - Agendove IS 0.13.xlsx (400.8 KB) …predpokladam, ze dnes by sa tie dokumenty mali obajvit aj na MetaIS https://metais.finance.gov.sk/studia/detail/ed6146af-477e-0052-d178-cc75c5dd7876?tab=documents ale pre kratkost casu na pripomienky do pondelka, to davam sem na platformu uz teraz…

…pre inspiraciu a pochopenie nasho pohladu prikladam aj nase pripomienky a vyjadrenie k nim zo strany UPVII, ktore sme tiez dostali vcera vecer a dnes sa snimi budeme zaoberat PRIPOMIENKOVACI FORMULAR_v03_SD.xlsx (25.9 KB)
SU OPII API_GW_v1.4_pripo SD_Vyjadrenie.docx (1.2 MB)

2 Likes