eLab posistemės integracijos dokumentacija - Local Development build (v0.3.21) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Nomenklatūrų ir kalsifikatorių API

Nomenklatūrų API

Naudojamos nomenklatūros

Šiuo metu Elab sistemoje naudojamų nomenklatūrų informaciją galima gauti naudojantis GET /fhir/CodeSystem/{id} API sąsaja. Galimos id reikšmės yra tokios:

Pavadinimas	Sistemos URL	Paskirtis
lt-lab-klt-nomenclature	https://www.medicinosnk.lt/CodeSystem/lt-lab-klt-nomenclature	Klinikinių laboratorinių tyrimų nomenklatūra
lt-lab-specimens	https://www.medicinosnk.lt/CodeSystem/lt-lab-specimens	Ėminių ir mėginių klasifikatorius
lt-lab-methods	https://www.medicinosnk.lt/CodeSystem/lt-lab-methods	Tyrimo metodų klasifikatorius
lt-lab-test-groups	https://www.medicinosnk.lt/CodeSystem/lt-lab-test-groups	Tyrimų grupių klasifikatorius
lt-lab-microorganisms	https://www.medicinosnk.lt/CodeSystem/lt-lab-microorganisms	Mikroorganizmų klasifikatorius
lt-lab-test-results	https://www.medicinosnk.lt/CodeSystem/lt-lab-test-results	Tyrimų rezultatų klasifikatorius
lt-lab-results-3plus	https://www.medicinosnk.lt/CodeSystem/lt-lab-results-3plus	3plius atsakymų klasifikatorius
lt-lab-results-4plus	https://www.medicinosnk.lt/CodeSystem/lt-lab-results-4plus	4plius atsakymų klasifikatorius
lt-lab-results-abo	https://www.medicinosnk.lt/CodeSystem/lt-lab-results-abo	ABO sistemos kraujo grupių klasifikatorius
lt-lab-results-abo-rh	https://www.medicinosnk.lt/CodeSystem/lt-lab-results-abo-rh	ABO ir Rezus sistemų kraujo grupių klasifikatorius
lt-lab-results-azk	https://www.medicinosnk.lt/CodeSystem/lt-lab-results-azk	Atsparumo žymenų klasifikatorius AZK
lt-lab-results-bldcomp	https://www.medicinosnk.lt/CodeSystem/lt-lab-results-bldcomp	Tyrimų rezultatų klasifikatorius BLDCOMP - Kraujo suderinamumo atsakymų klasifikatorius
lt-lab-results-bmrk	https://www.medicinosnk.lt/CodeSystem/lt-lab-results-bmrk	Tyrimų rezultatai BMRK - Bendrosios mikrobiologijos rezultatų klasifikatorius
lt-lab-results-gkivk	https://www.medicinosnk.lt/CodeSystem/lt-lab-results-gkivk	Tyrimų rezultatai GKIVK - Gleivių kiekio išmatose vertinimo klasifikatorius
lt-lab-results-ikvk	https://www.medicinosnk.lt/CodeSystem/lt-lab-results-ikvk	Tyrimų rezultatai IKVK - Išmatų konsistencijos vertinimo klasifikatorius
lt-lab-results-imkr	https://www.medicinosnk.lt/CodeSystem/lt-lab-results-imkr	Tyrimų rezultatai IMKR - Molekulinių infekcinių kokybinių rezultatų klasifikatorius
lt-lab-results-isrk	https://www.medicinosnk.lt/CodeSystem/lt-lab-results-isrk	Tyrimų rezultatai ISRK - Infekcinės serologijos rezultatų klasifikatorius
lt-lab-results-isvk	https://www.medicinosnk.lt/CodeSystem/lt-lab-results-isvk	Tyrimų rezultatai ISVK - Išmatų spalvos vertinimo klasifikatorius
lt-lab-results-jjda	https://www.medicinosnk.lt/CodeSystem/lt-lab-results-jjda	Tyrimų rezultatai JJDA - Jautrumo AMV rezultatų klasifikatorius
lt-lab-results-rnk	https://www.medicinosnk.lt/CodeSystem/lt-lab-results-rnk	Tyrimų rezultatai RNK - Rasta/Nerasta klasifikatorius
lt-lab-results-tnk	https://www.medicinosnk.lt/CodeSystem/lt-lab-results-tnk	Tyrimų rezultatai TNK - Teigiamas/Neigiamas klasifikatorius

Visi integraciniai taškai palaiko duomenų apsikeitimą tiek XML tiek JSON formatais. Rekomenduojamas apsikeitimo formatas - JSON. Norint naudotis XML duomenų apsikeitimu formatu tą reikia nurodyti užklausoje naudojantis _format parametru, daugiau informacijos galima rasti čia.

GET /fhir/CodeSystem/{id} - naujausios nomenklatūros gavimas pagal id.

Pateikiama naujausia klasifikatoriaus versija. Grąžinamas CodeSystem resursas.

Atsakymo laukai

Laukas	Aprašymas
resourceType	Grąžinamo resurso tipas
id	Identifikatorius
meta	Metaduomenys - versija ir atnaujinimo data
text	Išsamus aprašymas
url	Resurso nuoroda
version	Resurso versija
name	Resurso pavadinimas
status	Resurso būsena
Date	Sukūrimo data
description	Trumpas aprašymas
caseSensitive	Žymė, nurodanti, ar klasifikatorius skiria mažąsias ir didžiąsias raides
content	Klasifikatoriaus turinio būsena
concept	Klasifikatoriaus elementų sąrašas
code	Elemento kodas
display	Elemento atvaizdavimas
definition	Elemento aprašymas
designation	Papildoma informacija apie elementą

Pavyzdys: GET /fhir/CodeSystem/lt-lab-specimens - atsakymas.

GET /fhir/CodeSystem/{id}/_history - nomenklatūros pakeitimų istorijos gavimas pagal id.

Pateikiamos visos klasifikatoriaus versijos, įskaitant ir naujausią. Grąžinamas Bundle tipo resursas.

Atsakymo laukai

Laukas	Aprašymas
resourceType	Resurso tipas
id	Paieškos id
meta	Metaduomenys
total	Rezultatų kiekis
entry	Įrašų sąrašas

​Pavyzdys: GET /fhir/CodeSystem/lt-lab-specimens/_history - atsakymas.

GET /fhir/CodeSystem/{id}/_history/{versija} - specifinės nomenklatūros versijos gavimas pagal id ir istorinės versijos id.

Pateikiama konkreti istorinė klasifikatoriaus versija. Klasifikatoriaus versija turi būti nurodoma tokia, kokia yra saugoma laukelyje meta.versionId. Grąžinamas CodeSystem tipo resursas.

Pavyzdys: GET /fhir/CodeSystem/lt-lab-specimens/_history/1 - atsakymas.

GET /fhir/CodeSystem/_search?system={klasifikatoriausTipas}&version={klasifikatoriausVersija} - nomenklatūrų paieška pagal nomenklatūrų sistemą ir versiją.

Pateikiamas klasifikatorius pagal nurodytą klasifikatoriaus tipą ir versiją. Labai svarbu atkreipti dėmesį į tai, kad šioje užklausoje yra naudojama ne FHIR versija, bet versija, esantį nomenklatūros version lauke. Grąžinamas Bundle tipo resursas.

Pavyzdys: GET /fhir/CodeSystem/__search?system=https://www.medicinosnk.lt/CodeSystem/lt-lab-specimens&version=1.0.0 - atsakymas.

GET /fhir/CodeSystem/{id}/$diff?fromVersion={senesnėVersija}&toVersion={naujesnėVersija} - nomenklatūros pasikeitimų palyginimas tarp dviejų jos versijų.

Pateikiami pokyčiai tarp klasifikatoriaus FHIR versijų. Galima nurodyti parametrus fromVersion - nuo kokios versijos lyginama, ir toVersion - su kokia versija lyginama. Jeigu nenurodomas fromVersion, lyginama nuo priešpaskutinės naujausios versijos. Jeigu nenurodomas toVersion, lyginama su naujausia versija. Versija turi būti nurodoma iš resurso metadata.version lauko. Grąžinamas Parameters tipo resursas.

Atsakymo laukai

Laukas	Aprašymas
resourceType	Resurso tipas
parameter	Parametrų sąrašas
name	Parametro pavadinimas
part	Operaciją aprašančios dalys, susidedančios iš dalies pavadinimo ir reikšmės. type - operacijos tipas. Replace - pakeitimas, insert - naujas įrašas, delete - ištrintas įrašas. path - kelias iki parametro, kuriame įvyko pakeitimas. previousValue - buvusi reikšmė (fromVersion versijoje). value - esama reikšmė (toVersion versijoje).

Pavyzdys: GET /fhir/CodeSystem/lt-lab-specimens/$diff?fromVersion=1&toVersion=2 - atsakymas.

GET /fhir/CodeSystem/{id}/$check-version?version={versija} - patikrinimas ar yra naujesnė negu pateikta, nomenklatūros versija.

Pateikiamas atsakymas, ar egzistuoja naujesnė klasifikatoriaus versija, nei nurodyta parametre version. Versija turi būti nurodoma pagal resurso metadata.version lauką. Grąžinamas Parameters tipo resursas.

Atsakymo laukai

Laukas	Aprašymas
resourceType	Resurso tipas
parameter	Parametrų sąrašas. Parametrus sudaro parametro pavadinimas ir reikšmė. isNewerVersionAvailable - parametras nurodo, ar yra naujesnė resurso versija, nei nurodyta.

Pavyzdys: GET /fhir/CodeSystem/lt-lab-specimens/$check-version?version=1 - atsakymas.

GET /fhir/CodeSystem/$lookup?system={sistemosUrl}&code={nomenklatūrosKodas} - specifinės nomenklatūros reikšmės informacijos gavimas.

Pateikiamas vienas konkretus elementas iš nurodyto klasifikatoriaus pagal klasifikatoriaus kodą. system - klasifikatoriaus tipas (pagal CodeSystem url parametrą), code - norimo elemento kodas. Grąžinamas Parameters tipo resursas.

Atsakymo laukai

Laukas	Aprašymas
resourceType	Resurso tipas
parametrai	Parametrų sąrašas. name - klasifikatoriaus pavadinimas. version - klasifikatoriaus versija. display - elemento pavadinimas. designation - papildomi parametrai.

Pavyzdys: GET /fhir/CodeSystem/$lookup?system=https://www.medicinosnk.lt/CodeSystem/lt-lab-specimens&code=PRP - atsakymas.

GET fhir/CodeSystem/$get-file-list?type={nomenklatūrosTipas} - LOINC arba SNOMED nomenklatūrų failų sąrašo gavimas.

Pateikiamas LOINC arba SNOMED nomenklatūrų failų sąrašas. Nurodžius parametrą type=LOINC, grąžinama LOINC, o SNOMED - SNOMED nomenklatūra. Grąžinamas Parameters tipo resursas.

Atsakymo laukai

Laukas	Aprašymas
resourceType	Resurso tipas
parameter	Parametrų sąrašas
name	Failo pavadinimas
part	Operaciją aprašančios dalys, susidedančios iš dalies pavadinimo ir reikšmės. version - nomenklatūrų versija. versionType - versijos tipas. releaseType - leidimo tipas. downloadLink - atsisiuntimo nuoroda.

Pavyzdys: GET /fhir/CodeSystem/$get-file-list?type=LOINC - atsakymas.

GET fhir/CodeSystem/$get-file?filename={failoPavadinimas} - nomenklatūrų failo gavimas.

Pateikiamas konkretaus LOINC arba SNOMED nomenklatūrų tipo failo pavadinimas. Failo pavadinimas gaunamas iš nomenklatūrų failų sąrašo gavimo užklausos. Grąžinamas LOINC arba SNOMED nomenklatūrų failas.

Pavyzdys: GET /fhir/CodeSystem/$get-file?filename=Loinc_2.75.zip