Pravidlá pre implementáciu dátovej interoperability pre API ISVS

Tento dokument definuje spôsob, akým je potrebné implementovať API informačných systémov verejnej správy v súlade s dátovou interoperabilitou.

Slovník pojmov

referenčné údaje - údaje ISVS, ktoré je nutné používať (synchronizovať, resp. stotožňovať) v agendových systémoch verejnej správy

štrukturálne metadáta - metadáta definujúce dátové štruktúry pre reprezentáciu údajov a číselníkov v ISVS 

referenčné štrukturálne metadáta: povinne používané štrukturálne metadáta ako Centrálny model údajov verejnej správy, základné číselníky, hierarchie a tezauri

A.Sprístupňovanie údajov z referenčných registrov

1. V prípade že vyhlásený referenčný register poskytuje údaje cez API, tak toto API je súlade s princípmi dátovej interoperability ak
   1. vo vrátených údajoch sú objekty evidencie identifikované prostredníctvom schválených Jednotných referencovateľných identifikátorov (5★), vytváraných podľa Pravidiel tvorby referencovateľných identifikátorov,
   2. vo vrátených údajov sú všetky referenčné štrukturálne metadáta (Centrálny model údajov, základné číselníky) identifikované tiež prostredníctvom schválených Jednotných referencovateľných identifikátorov,
   3. v prípade, že referenčný register používa vlastné štrukturálne metadáta, ktoré je možné ztotožniť s referenčnými štrukturálnymi metadátami, je API povinné použiť  tieto údaje podľa bodu 1.b.,
   4. v prípade, že referenčný register používa štrukturálne metadáta nepatriace do referenčných štrukturálnych metadát, je nutné ich identifikovať a reprezentovať do formy nereferenčných štrukturálnych metadát, kde sa používajú lokálne (5★) URI identifikátory. 
2. Ak referenčný register obsahuje údaje, ktoré nie sú referencované z iného referenčného registra, tak API je nutné tieto údaje zreferencovať a používať Jednotné referencovateľné identifikátory objektov evidencie z daných referenčných údajov.