MedlinePlus Connect: web usluga

Sadržaj

• Pregled web usluga
• Izlazni parametri
• Zahtjevi za dijagnostičke kodove
• Izborni parametri
• Opis odabranih atomskih elemenata (ili JSON objekata) u odgovoru na zahtjeve koda problema
• Primjeri zahtjeva za šifre problema
• Povezane usluge i datoteke
• Zahtjevi za informacije o lijekovima
• Izborni parametri
• Opis odabranih atomskih elemenata (ili JSON objekata) u odgovoru na zahtjeve za lijekovima
• Primjeri zahtjeva za kodovima lijekova
• Zahtjevi za informacijama o laboratorijskim testovima
• Izborni parametri
• Opis odabranih atomskih elemenata (ili JSON objekata) u odgovoru na zahtjeve za laboratorijskim ispitivanjem
• 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 usluge koja odgovara na zahtjeve na temelju:

Možete se povezati i prikazati podatke koje vraća MedlinePlus Connect. Ne možete kopirati stranice MedlinePlus na svoje web mjesto. Ako upotrebljavate podatke s web usluge MedlinePlus Connect, navedite da su informacije s MedlinePlus.gov, ali nemojte koristiti logotip MedlinePlus ili na drugi način implicirate da MedlinePlus podržava vaš određeni proizvod. Molimo pogledajte NLM-ovu API stranicu za daljnje smjernice. Za više informacija o povezivanju sa sadržajem MedlinePlus izvan ove usluge, pogledajte naše smjernice i upute za povezivanje.

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.

Pregled web usluga

Parametri za zahtjeve za web uslugom sukladni su s HL7 Vodičem za implementaciju zahtjeva za znanjem koji se temelji na kontekstu (Infobutton). Odgovor zasnovan na REST-u sukladan je s HL7 Vodičem za implementaciju arhitektonski orijentirane usluge orijentirane na kontekst (Infobutton). Izlaz zahtjeva može biti XML u formatu Atom feeda, JSON ili JSONP.

Struktura zahtjeva označava koju vrstu koda šaljete. U svim je slučajevima osnovni URL web usluge: https://connect.medlineplus.gov/service

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.

Izlazni parametri

Ovi su parametri neobavezni. Ako ih izostavite, zadani odgovor su informacije na engleskom u XML formatu.

Jezik
Odredite želite li da odgovor 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

Format
Utvrdite želite li da format odgovora bude XML, JSON ili JSONP. Zadani je XML.

Da biste zatražili JSON, upotrijebite:

knowledgeResponseType = application / json

Za JSONP upotrijebite:

knowledgeResponseType = application / javascript & callback = CallbackFunction gdje je CallbackFunction ime kojemu dajete funkciju povratnog poziva.

Za odgovor u XML-u upotrijebite:

knowledgeResponseType = text / xml ili ostavite parametar knowledgeResponseType izvan zahtjeva.

Zahtjevi za dijagnostičke kodove

Za kôd problema, MedlinePlus Connect vratit će veze i informacije sa stranica s temama o zdravlju MedlinePlus, genetičkih stranica ili stranica s drugih NIH instituta.

MedlinePlus Connect vratit će sljedeće:

Ne može uvijek postojati podudaranje za svaki kod. U tim će slučajevima MedlinePlus Connect vratiti null odgovor.

Osnovni URL usluge je: https://connect.medlineplus.gov/service

Za bilo koji upit ove usluge postoje dva potrebna parametra:

1. Sustav kodova
   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. Kodirati
   Identificirajte stvarni kod koji pokušavate potražiti:
   mainSearchCriteria.v.c = 250,33

Izborni parametri

Naslov koda
Također možete identificirati naziv / naslov šifre problema. Međutim, ove informacije ne utječu na odgovor (za razliku od web aplikacije MedlinePlus Connect u kojoj se mogu koristiti podaci o imenu / naslovu). mainSearchCriteria.v.dn = Dijabetes melitus s drugom nekontroliranom komom tipa 1 Pogledajte gornji odjeljak Izlazni parametri za detalje o jeziku i izlaznim formatima.

Opis odabranih atomskih elemenata (ili JSON objekata) u odgovoru na zahtjeve koda problema

Element	Čvor klase	Opis
titula		Naslov podudarne stranice s zdravstvenom temom MedlinePlus ili GHR stranice
veza		URL za podudarnu stranicu teme zdravlja MedlinePlus ili GHR stranicu
Sažetak		Cjelovit sažetak za zdravstvenu temu. To uključuje ugrađene veze na druge relevantne zdravstvene teme i sve oblikovanje, uključujući nabrajanje i razmake između odlomaka. Sažetak je u HTML-u. Za GHR stranice pruža se prvi odjeljak cijele stranice.
Sažetak		Sinonimi za temu. Oni se na stranici sa zdravstvenim temama nazivaju "Također se nazivaju". Nisu sve teme izraze "Također se nazivaju".
Sažetak		Priznanje priznanja za sažeti tekst, ako je glavnina sažetka bila iz druge savezne agencije. Nemaju svi sažeci atribuciju. Neatribuirani tekst originalan je za MedlinePlus.
Sažetak		Odabrane poveznice povezane s temom. To uključuje naziv stranice, URL i povezanu organizaciju (ako je primjenjivo). Veze su oblikovane na popisu s grafičkim oznakama. Te veze nemaju sve teme. Broj veza može se kretati od nule do desetaka.

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/service?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103 & mainSearchCriteria.vc = 250.33 & mainSearchCriteria.v.dn = Dijabetes% 20mellitus% 20s% 20o% %koma% 20tip% 201% 20nekontroliran & informationRecipient.languageCode.c = es

Pacijent s istom dijagnozom, ali traženi format je JSON, a jezik je engleski: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application / json

Pacijent s dijagnozom "Upala pluća zbog pseudomonase" pomoću SNOMED CT koda 41381004: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v.d. Upala pluća% 20iz% 20do% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.languageCode.c = hr

Pacijent s istom dijagnozom, ali traženi format je JSONP: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javascript&callback=CallbackCallbackCallback

Povezane usluge i datoteke

Da biste primali teme o zdravlju MedlinePlus kao odgovor na tekstualne zahtjeve, za razliku od kodova problema, istražite MedlinePlus web uslugu. Također, ako vam je potreban cijeli niz zdravstvenih tema MedlinePlus u XML formatu, pogledajte našu stranicu XML datoteka.

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 engleskom ili španjolskom jeziku.

Za zahtjeve za engleskim informacijama o lijekovima, ako ne pošaljete NDC ili RXCUI ili ako na temelju koda ne pronađemo podudaranje, aplikacija će upotrijebiti tekstni niz koji pošaljete za prikaz najboljeg podudaranja podataka o lijeku. Na zahtjeve za španjolskim informacijama o lijekovima, MedlinePlus Connect odgovara samo na NDC ili RXCUI i ne koristi tekstne nizove. Odgovor je moguć na engleskom, ali na španjolskom nema odgovora.

Web usluga MedlinePlus Connect vratit će sljedeće:

Na jedan zahtjev za lijekom može biti više odgovora. Ne može uvijek postojati podudaranje za svaki zahtjev. U tim će slučajevima MedlinePlus Connect vratiti null odgovor.

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

Da biste poslali zahtjev, dodajte ove podatke:

1. Sustav kodova
   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

   MedlinePlus Connect također može prihvatiti tekstualni niz za zahtjeve za informacijama o lijekovima na engleskom jeziku, ali morate naznačiti da tražite informacije o lijekovima tako što ćete uključiti jedan od dva gore navedena sustava kodova.
2. Kodirati
   Identificirajte stvarni kod koji pokušavate potražiti. (Preferira se za engleski, obavezno za španjolski)
   mainSearchCriteria.v.c = 637188
3. Naziv lijeka
   Identificirajte naziv lijeka tekstnim nizom. (Neobvezno za engleski, ne koristi se za španjolski)
   mainSearchCriteria.v.dn = Chantix 0,5 mg oralna tableta

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

Izborni parametri

Naslov koda

Kada šaljete zahtjev za informacije na engleskom jeziku, možete uključiti neobavezni parametar naziva lijeka. Ovo je detaljno opisano u gornjem odjeljku. mainSearchCriteria.v.dn = Chantix 0,5 mg oralna tableta

Pogledajte gornji odjeljak Izlazni parametri za detalje o jeziku i izlaznim formatima.

Opis odabranih atomskih elemenata (ili JSON objekata) u odgovoru na zahtjeve za lijekovima

Element	Opis
titula	Naslov za podudarnu stranicu lijekova MedlinePlus
veza	URL odgovarajuće stranice lijekova MedlinePlus
Autor	Atribucija izvora za informacije o lijekovima

Primjeri zahtjeva za kodovima lijekova

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

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

Da biste zatražili podatke od NDC-a za govornika španjolskog, vaš bi zahtjev trebao izgledati ovako: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-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 zahtjeve na engleskom jeziku. Vaš zahtjev mogao bi izgledati ovako: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.v.dn=Chantix%200.5%20MG%20Oral%20Tablet&informationRecipient.languageCode.c = hr

Zahtjevi za informacijama o laboratorijskim testovima

MedlinePlus Connect osigurava podudaranje s informacijama o laboratorijskim ispitivanjima kada prima LOINC zahtjev. Usluga može pružiti odgovor na engleskom ili španjolskom jeziku.

Web usluga MedlinePlus Connect vratit će sljedeće:

Ne može uvijek postojati podudaranje za svaki kod. U tim će slučajevima MedlinePlus Connect vratiti null odgovor.

Osnovni URL usluge je: https://connect.medlineplus.gov/service

To su dva potrebna parametra za bilo koji laboratorijski testni upit ove usluge:

1. Sustav kodova
   

   Utvrdite da koristite sustav LOINC koda. Koristiti:

   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. Kodirati
   identificirajte stvarni kod koji pokušavate potražiti:
   mainSearchCriteria.v.c = 3187-2

Izborni parametri

Naslov koda

Također možete identificirati naziv laboratorijskog testa. Međutim, ove informacije ne utječu na odgovor. mainSearchCriteria.v.dn = Analiza faktora IX

Pogledajte gornji odjeljak Izlazni parametri za detalje o jeziku i izlaznim formatima.

Opis odabranih atomskih elemenata (ili JSON objekata) u odgovoru na zahtjeve za laboratorijskim ispitivanjem

Element	Opis
titula	Naslov odgovarajuće stranice laboratorijskog testa MedlinePlus
veza	URL za podudarnu laboratorijsku testnu stranicu MedlinePlus
Sažetak	Isječak iz sadržaja stranice
Autor	Izvorna atribucija za sadržaj laboratorijskog testa

Primjeri zahtjeva za laboratorijske testove

Da biste zatražili podatke za govornike engleskog jezika, vaš zahtjev može izgledati kao jedan od sljedećih: https://connect.medlineplus.gov/service?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/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.languageuage. = hr

Da biste zatražili informacije za govornika španjolskog, vaš zahtjev može izgledati kao jedan od sljedećih: https://connect.medlineplus.gov/service?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/service?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