MedlinePlus Connect: web aplikacija

Sadržaj

• Pregled web aplikacija
• Zahtjevi za dijagnostičke kodove
• Izborni parametri
• Primjeri zahtjeva za šifre problema
• Zahtjevi za informacije o lijekovima
• Izborni parametri
• Primjeri zahtjeva za kodovima lijekova
• Zahtjevi za informacijama o laboratorijskim testovima
• Izborni parametri
• Primjeri zahtjeva za laboratorijske testove
• Politika prihvatljive upotrebe
• Više informacija

MedlinePlus Connect dostupan je kao web aplikacija ili web usluga. Ispod su tehnički detalji za implementaciju web aplikacije koja odgovara na zahtjeve na temelju:

Ako se odlučite za MedlinePlus Connect, prijavite se na popis e-pošte kako biste pratili razvoj i razmjenjivali ideje sa svojim kolegama. Recite nam primjenjujete li MedlinePlus Connect kontaktirajući nas. Možete se povezati i prikazati podatke koje pruža MedlinePlus Connect. Za više informacija o povezivanju sa sadržajem MedlinePlus izvan ove usluge, pogledajte naše smjernice i upute za povezivanje.

Pregled web aplikacija

API za web aplikaciju sukladan je specifikacijama implementacije zahtjeva za znanjem HL7 za pronalaženje znanja o kontekstu (Infobutton). Struktura zahtjeva označava koju vrstu koda šaljete. U svim je slučajevima osnovni URL web-aplikacije: https://connect.medlineplus.gov/application

MedlinePlus Connect koristi HTTPS veze. HTTP zahtjevi neće biti prihvaćeni, a postojeće implementacije koje koriste HTTP trebaju se ažurirati na HTTPS.

Zahtjevi za dijagnostičke kodove

MedlinePlus Connect podudara se s ICD-10-CM, ICD-9-CM ili SNOMED CT kodovima sa srodnim stranicama MedlinePlus zdravstvenih tema, genetičkim stranicama ili stranicama drugih instituta NIH. Na primjer, pacijentu kojem je dijagnosticiran ICD-9-CM kod 493.12, Ekstrinzična astma s pogoršanjem, mogla bi se predstaviti poveznica u elektroničkom zdravstvenom kartonu (EHR) koji vodi na MedlinePlus stranicu Astma.

Ova veza prikazuje stranicu s praznim okvirom za pretraživanje. Za bilo koji upit ovoj aplikaciji potrebna su dva parametra:

1. Odredite sustav s kodom problema koji ćete koristiti.
   

   Za upotrebu ICD-10-CM:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90

   Za upotrebu ICD-9-CM:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103

   Za upotrebu SNOMED CT-a:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96

2. Identificirajte stvarni kod koji pokušavate potražiti:
   mainSearchCriteria.v.c = 250,33

Izborni parametri

Identificirajte ime / naslov šifre problema. Slanje nijednog koda rezultirat će upitom na tražilici MedlinePlus. Ako navedete kôd i ime / naslov koda, ali MedlinePlus Connect nema rezultata, na stranici s odgovorima prikazat će se okvir za pretraživanje MedlinePlus unaprijed popunjen s imenom / naslovom. mainSearchCriteria.v.dn = Dijabetes melitus s nekom nekontroliranom komom tipa 1

Utvrdite želite li da zahtjev bude na engleskom ili španjolskom jeziku. MedlinePlus Connect pretpostavit će da je engleski jezik jezik ako nije naveden.

Ako želite da odgovor na traženje koda problema bude na španjolskom, upotrijebite: informationRecipient.languageCode.c = es
(= prihvaćen je i sp)

Da biste odredili engleski, upotrijebite sljedeće: informationRecipient.languageCode.c = hr

Primjeri zahtjeva za šifre problema

Potpuni zahtjev za dijabetes melitus s nekom nekontroliranom komom tipa 1, ICD-9 kod 250.33, za pacijenta koji govori španjolski imao bi sljedeću URL adresu: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103 & mainSearchCriteria.vc = 250.33 & mainSearchCriteria.v.dn = Dijabetes% 20mellitus% 20s% 20o% %koma% 20tip% 201% 20nekontrolirano & informationRecipient.languageCode.c = es

Pacijent kojem je dijagnosticirana "Upala pluća zbog pseudomonas" pomoću SNOMED CT koda 41381004: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchnriter=v. Upala pluća% 20iz% 20do% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.languageCode.c = hr

Upit slobodnog oblika, bez sustava koda ili koda problema, upotrebljavat će tražilicu MedlinePlus (samo na engleskom): https://connect.medlineplus.gov/application?mainSearchCriteria.v.dn=Type+2+Diabetes

Zahtjevi za informacije o lijekovima

MedlinePlus Connect pruža najbolje podatke o lijekovima koji se podudaraju prilikom primanja RXCUI. Također pruža dobre rezultate prilikom primanja NDC koda. MedlinePlus Connect može pružiti odgovore na zahtjeve za kodove lijekova na engleskom ili španjolskom jeziku i vratit će vezu na stranicu s rezultatima s najboljim podudaranjima iz podataka o lijeku MedlinePlus.

Za zahtjeve za engleskim informacijama o lijekovima, ako ne pošaljete NDC ili RXCUI kôd ili ako na osnovu koda ne pronađemo podudaranje, upotrijebit ćemo tekstualni niz koji pošaljete za prikaz najboljeg podudaranja podataka o lijeku. Na zahtjeve za španjolskim informacijama o lijekovima, MedlinePlus Connect odgovara samo NDC-ima ili RXCUI-ima; ne koristi tekstne nizove. Moguće je dobiti odgovor na engleskom, ali nema odgovora na španjolskom.

Na jedan zahtjev za lijekom može biti više odgovora. Ne može uvijek postojati podudaranje za svaki zahtjev. Ako MedlinePlus Connect pronađe null odgovor na zahtjev za lijekom, program prikazuje okvir za pretraživanje web mjesta MedlinePlus. Korisnik može upisati ime lijeka i možda će dobiti dobar odgovor.

Za zahtjeve za informacijama o lijekovima osnovni URL je: https://connect.medlineplus.gov/application

Zahtjevi za informacije o lijekovima na engleskom i španjolskom jeziku imaju različite zahtjeve. Da biste poslali zahtjev, dodajte ove podatke:

1. Utvrdite vrstu koda za lijek koji šaljete. (Obavezno za engleski i španjolski)
   

   Za upotrebu RXCUI:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88

   Za NDC upotrebu:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69

2. Identificirajte stvarni kod koji pokušavate potražiti. (Preferira se za engleski, obavezno za španjolski)
   mainSearchCriteria.v.c = 637188
3. Identificirajte naziv lijeka tekstnim nizom. (Neobvezno za engleski, ne koristi se za španjolski)
   mainSearchCriteria.v.dn = Chantix 0,5 mg oralna tableta

Za zahtjeve na engleskom jeziku trebali biste identificirati barem sustav koda i kod ili sustav koda i naziv lijeka. Pošaljite sve tri za najbolje rezultate za zahtjeve na engleskom jeziku. Za španjolske zahtjeve trebali biste identificirati sustav kodova i kod.

Izborni parametri

Kada šaljete zahtjev za informacije na engleskom jeziku, možete uključiti neobavezni parametar naziva lijeka. Ovo je detaljno opisano u gornjem odjeljku. Ovaj se parametar ne koristi za španjolske zahtjeve.

Utvrdite želite li da zahtjev bude na engleskom ili španjolskom jeziku. MedlinePlus Connect pretpostavit će da je engleski jezik jezik ako nije naveden.

Ako želite da odgovor na traženje šifre lijeka bude na španjolskom, upotrijebite: informationRecipient.languageCode.c = es (= prihvaćen je i sp)

Da biste odredili engleski, upotrijebite sljedeće: informationRecipient.languageCode.c = hr

Primjeri zahtjeva za kodovima lijekova

Vaš zahtjev za informacijama o lijeku trebao bi izgledati kao jedan od sljedećih.

Da biste zatražili podatke putem RXCUI-a, vaš zahtjev trebao bi izgledati ovako: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.88&mainSearchCriteria.vc=%20637188%20&mainSearchCriteria.v.dn = Chantix% 200,5% 20MG% 20Oral% 20Tablica i informacijeRecipient.languageCode.c = hr

Da biste zatražili informacije od NDC-a za govornika španjolskog, vaš bi zahtjev trebao izgledati ovako: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=%2000310-0751 -39 & informationRecipient.languageCode.c = es

Da biste poslali tekstualni niz bez koda lijeka, morate svoj upit identificirati kao zahtjev tipa NDC, tako da MedlinePlus Connect zna da tražite informacije o lijeku. Ovo će raditi samo za engleski jezik. Vaš zahtjev mogao bi izgledati ovako: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.v.dn=Chantix%200.5%20MG%20Oral%20Tablet&informationRecipient.languageCode.cng = hr

Zahtjevi za informacijama o laboratorijskim testovima

MedlinePlus Connect osigurava podudaranje s informacijama o laboratorijskim ispitivanjima kada prima LOINC zahtjev. MedlinePlus Connect može pružiti odgovore na zahtjeve za laboratorijskim ispitivanjem na engleskom ili španjolskom jeziku i vratit će vezu do stranice rezultata s najboljim podudaranjima iz podataka laboratorijskog testa MedlinePlus.

Za zahtjeve za informacijama o laboratorijskim testovima, osnovni URL je: https://connect.medlineplus.gov/application

To su dva potrebna parametra za bilo koji laboratorijski testni upit za ovu aplikaciju:

1. Utvrdite da koristite sustav LOINC koda.
   

   Za upotrebu LOINC-a:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1

   MedlinePlus Connect također prihvaća:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79

2. Identificirajte stvarni kod koji pokušavate potražiti.
   mainSearchCriteria.v.c = 3187-2

Izborni parametri

Odredite naziv / naslov laboratorijskog testa. Međutim, ove informacije ne utječu na odgovor. mainSearchCriteria.v.dn = Analiza faktora IX

Utvrdite želite li da zahtjev bude na engleskom ili španjolskom jeziku. MedlinePlus Connect pretpostavit će da je engleski jezik jezik ako nije naveden.

Ako želite da odgovor na pretraživanje koda problema bude na španjolskom, upotrijebite: informationRecipient.languageCode.c = es (= prihvaćen je i sp)

Da biste odredili engleski, upotrijebite sljedeće: informationRecipient.languageCode.c = hr

Upit slobodnog oblika, bez sustava koda ili laboratorijskog koda, upotrebljavat će tražilicu MedlinePlus. Ovaj je pristup učinkovitiji s dijagnozama (pogledajte gore navedene informacije o kodu problema) umjesto tekstualnih nizova laboratorijskog testa. Vaš zahtjev za informacijama o laboratorijskom testu trebao bi izgledati kao jedan od sljedećih.

Primjeri zahtjeva za laboratorijske testove

Da biste zatražili informacije za govornika engleskog jezika, vaš zahtjev može izgledati kao jedan od sljedećih: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = Factor% 20IX% 20assay & informationRecipient.languageCode.c = hr https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.language. = hr

Da biste zatražili informacije za govornika španjolskog, vaš zahtjev može izgledati kao jedan od sljedećih: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = Factor% 20IX% 20assay & informationRecipient.languageCode.c = es https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.language. = es

Politika prihvatljive upotrebe

Kako bi izbjegao preopterećenje MedlinePlus poslužitelja, NLM zahtijeva da korisnici MedlinePlus Connect šalju ne više od 100 zahtjeva u minuti po IP adresi. Zahtjevi koji premašuju ovo ograničenje neće se servisirati i usluga se neće vratiti 300 sekundi ili dok stopa zahtjeva ne padne ispod ograničenja, ovisno o tome što kasnije nastupi. Da biste ograničili broj zahtjeva koje šaljete na Connect, NLM preporučuje rezultate predmemoriranja za razdoblje od 12 do 24 sata.

Ovo pravilo postoji kako bi se osiguralo da usluga ostane dostupna i dostupna svim korisnicima. Ako imate određeni slučaj korištenja koji zahtijeva da velikom broju zahtjeva pošaljete MedlinePlus Connect i time premašite ograničenje stope zahtjeva navedeno u ovim pravilima, kontaktirajte nas. Osoblje NLM-a procijenit će vaš zahtjev i utvrditi može li se odobriti iznimka. Također pregledajte dokumentaciju za MedlinePlus XML datoteke. Te XML datoteke sadrže cjelovite zapise o zdravstvenim temama i mogu poslužiti kao alternativna metoda pristupa MedlinePlus podacima.

Više informacija