MedlinePlus Connect: verkkopalvelu
Sisältö
- Verkkopalvelun yleiskatsaus
- Lähtöparametrit
- Diagnoosi (ongelma) -koodien pyynnöt
- Valinnaiset parametrit
- Valittujen atomielementtien (tai JSON-objektien) kuvaus vastauksena ongelmakoodipyyntöihin
- Esimerkkejä ongelmakoodien pyynnöistä
- Liittyvät palvelut ja tiedostot
- Lääketietopyynnöt
- Valinnaiset parametrit
- Valittujen atomielementtien (tai JSON-objektien) kuvaus vastauksena lääkepyyntöihin
- Esimerkkejä lääkekoodipyynnöistä
- Lab-testitietoja koskevat pyynnöt
- Valinnaiset parametrit
- Valittujen atomielementtien (tai JSON-objektien) kuvaus vastauksena laboratoriotestipyyntöihin
- Esimerkkejä laboratoriotestejä koskevista pyynnöistä
- Hyväksyttävää käyttöä koskeva käytäntö
- Lisää tietoa
MedlinePlus Connect on saatavana verkkosovelluksena tai verkkopalveluna. Alla on tekniset yksityiskohdat verkkopalvelun toteuttamiseksi, joka vastaa pyyntöihin seuraavien perusteella:
Voit linkittää ja näyttää MedlinePlus Connectin palauttamat tiedot. Et saa kopioida MedlinePlus-sivuja sivustollesi. Jos käytät MedlinePlus Connect -verkkopalvelun tietoja, ilmoita, että tiedot ovat MedlinePlus.gov -yhtiöltä, mutta älä käytä MedlinePlus-logoa tai tarkoita muuten, että MedlinePlus tukee tiettyä tuotetta. Katso lisätietoja NLM: n API-sivulta. Lisätietoja linkittämisestä MedlinePlus-sisältöön tämän palvelun ulkopuolella on linkittämisen ohjeissa ja ohjeissa.
Jos päätät käyttää MedlinePlus Connectia, kirjaudu sähköpostilistalle pysyäksesi kehityksessä mukana ja vaihtamaan ideoita kollegojesi kanssa. Kerro meille, jos otat MedlinePlus Connect käyttöön ottamalla meihin yhteyttä.
Verkkopalvelun yleiskatsaus
Verkkopalvelupyyntöjen parametrit ovat HL7 Context-Aware Knowledge Retrieval (Infobutton) Knowledge Request URL-pohjaisen toteutusoppaan mukaisia. REST-pohjainen vastaus on HL7 Context-Aware Knowledge Retrieval (Infobutton) -palvelukeskeisen arkkitehtuurin toteutusoppaan mukainen. Pyynnön tulos voi olla XML Atom-syötemuodossa, JSON tai JSONP.
Pyynnön rakenne osoittaa, minkä tyyppistä koodia lähetät. Kaikissa tapauksissa verkkopalvelun perus-URL on: https://connect.medlineplus.gov/service
MedlinePlus Connect käyttää HTTPS-yhteyksiä. HTTP-pyyntöjä ei hyväksytä, ja HTTP: tä käyttävien nykyisten toteutusten tulisi päivittyä HTTPS: ään.
Lähtöparametrit
Nämä parametrit ovat valinnaisia. Jos jätät ne pois, oletusarvo on englanninkielinen tieto XML-muodossa.
Kieli
Tunnista, haluatko vastauksen englanniksi vai espanjaksi. MedlinePlus Connect olettaa, että kieli on englanti, jos sitä ei ole määritetty.
Jos haluat vastauksen ongelmakoodihakuun olevan espanjaksi, käytä: informationRecipient.languageCode.c = es
(= myös sp hyväksytty)
Määritä englanti seuraavasti: informationRecipient.languageCode.c = fi
Muoto
Määritä, haluatko vastauksen muodon olla XML, JSON tai JSONP. XML on oletusarvo.
- Jos haluat pyytää JSONia, käytä:
- knowledgeResponseType = sovellus / json
- Käytä JSONP: ssä:
- knowledgeResponseType = application / javascript & callback = CallbackFunction jossa CallbackFunction on nimi, jonka annat takaisinsoittotoiminnolle.
- Käytä vastausta XML: ssä:
- knowledgeResponseType = text / xml tai jätä knowResponseType-parametri pois pyynnöstä.
Diagnoosi (ongelma) -koodien pyynnöt
MedlinePlus Connect palauttaa ongelmakoodia koskevat linkit ja tiedot MedlinePlus-terveysaiheiden sivuilta, genetiikkasivuilta tai muiden NIH-instituuttien sivuilta.
MedlinePlus Connect palauttaa seuraavat:
Kullekin koodille ei aina välttämättä löydy vastaavuutta. Tällöin MedlinePlus Connect palauttaa tyhjän vastauksen.
Palvelun perus-URL on: https://connect.medlineplus.gov/service
Kaikille tämän palvelun kyselyille vaaditaan kaksi parametria:
- Koodijärjestelmä
Tunnista käyttämäsi ongelmakoodijärjestelmä.- ICD-10-CM-käyttö:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90
- ICD-9-CM-käyttö:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103
- SNOMED CT -käyttöön:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96
- Koodi
Tunnista todellinen koodi, jota yrität etsiä:
mainSearchCriteria.v.c = 250,33
Valinnaiset parametrit
Koodin nimi
Voit myös tunnistaa ongelmakoodin nimen / otsikon. Nämä tiedot eivät kuitenkaan vaikuta vastaukseen (toisin kuin MedlinePlus Connect -verkkosovellus, jossa nimi / otsikkotietoja voidaan käyttää). mainSearchCriteria.v.dn = Diabetes mellitus muiden koomatyyppien 1 hallitsemattomien kanssa. Katso edellisestä kohdasta Tulostusparametrit lisätietoja kielestä ja tulostusmuodoista.
Valittujen atomielementtien (tai JSON-objektien) kuvaus vastauksena ongelmakoodipyyntöihin
| Elementti | Luokan solmu | Kuvaus |
|---|---|---|
| otsikko | Yhteensopivan MedlinePlus-terveystietosivun tai GHR-sivun otsikko | |
| linkki | Yhteensopivan MedlinePlus-terveystietosivun tai GHR-sivun URL-osoite | |
| yhteenveto | Täydellinen yhteenveto terveysaiheesta. Tämä sisältää upotetut linkit muihin asiaankuuluviin terveysaiheisiin ja kaiken muotoilun, mukaan lukien luettelomerkit ja kappaleiden välit. Yhteenveto on HTML-muodossa. GHR-sivuille annetaan koko sivun ensimmäinen osa. | |
| yhteenveto | Aiheen synonyymit. Näitä kutsutaan "kutsutaan myös" terveysaiheiselle sivulle. Kaikissa aiheissa ei ole termiä "kutsutaan myös". | |
| yhteenveto | Yhteenvetotekstin attribuutiovahvistus, jos suurin osa yhteenvedosta on peräisin toisesta liittovaltion virastosta. Kaikilla yhteenvedoilla ei ole attribuutiota. Määrittelemätön teksti on alkuperäinen MedlinePlus-ohjelmalle. | |
| yhteenveto | Valitut aiheeseen liittyvät linkit. Tämä sisältää sivun nimen, URL-osoitteen ja siihen liittyvän organisaation (tarvittaessa). Linkit on muotoiltu luettelomerkillä. Kaikilla aiheilla ei ole näitä linkkejä. Linkkien määrä voi vaihdella nollasta kymmeniin. |
Esimerkkejä ongelmakoodien pyynnöistä
Täydellisellä Diabetes Mellitus -pyynnöllä, jolla on muu kooma-tyypin 1 hallitsematon ICD-9-koodi 250.33, espanjankieliselle potilaalle tulisi olla seuraava URL-osoite: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103 & mainSearchCriteria.vc = 250.33 & mainSearchCriteria.v.dn = Diabetes% 20mellitus% 20with% 20other% 20coma% 20type% 201% 20controlled & informationRecipient.languageCode.c = es
Potilas, jolla on sama diagnoosi, mutta pyydetty muoto on JSON ja kieli on englanti: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application / json
Potilas, jolla on diagnosoitu "Pseudomonas-aiheuttama keuhkokuume" SNOMED-CT-koodilla 41381004: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v.dn= Keuhkokuume% 20due% 20to% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.languageCode.c = fi
Potilas, jolla on sama diagnoosi, mutta pyydetty muoto on JSONP: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javascript&callback=
Liittyvät palvelut ja tiedostot
Tutki MedlinePlus-verkkopalvelua saadaksesi MedlinePlus-terveysaiheita vastauksena tekstipyyntöihin ongelmakoodien sijaan. Jos tarvitset myös koko MedlinePlus-terveysaiheiden sarjan XML-muodossa, katso XML-tiedostosivumme.
Lääketietopyynnöt
MedlinePlus Connect tarjoaa parhaat huumausainetiedot ottamalla vastaan RXCUI. Se tarjoaa myös hyviä tuloksia vastaanotettaessa NDC-koodia. MedlinePlus Connect voi antaa vastauksia englanniksi tai espanjaksi.
Jos et lähetä NDC: tä tai RXCUI: ta tai jos emme löydä vastausta koodin perusteella, englanninkielisiä lääketietotietopyyntöjä varten sovellus käyttää lähettämääsi tekstimerkkijonoa parhaan huumausainetiedon ottelun näyttämiseksi. MedlinePlus Connect vastaa espanjalaisten lääketietojen pyyntöihin vain NDC- tai RXCUI-tiedostoihin eikä käytä tekstimerkkijonoja. On mahdollista saada vastaus englanniksi, mutta ei vastausta espanjaksi.
MedlinePlus Connect -verkkopalvelu palauttaa seuraavat:
Yhdelle lääkepyynnölle saattoi olla useita vastauksia. Kutakin pyyntöä ei aina voida löytää. Tällöin MedlinePlus Connect palauttaa tyhjän vastauksen.
Huumetietopyyntöjen perus-URL on: https://connect.medlineplus.gov/service
Lisää pyyntö lähettämällä nämä tiedot:
- Koodijärjestelmä
Tunnista lähettämäsi lääkekoodityyppi. (Vaaditaan englanniksi ja espanjaksi)- RXCUI-käyttöön:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88
- NDC-käyttöön:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69
- Koodi
Tunnista todellinen koodi, jota yrität etsiä. (Suositellaan englanniksi, vaaditaan espanjaksi)
mainSearchCriteria.v.c = 637188 - Lääkkeen nimi
Tunnista lääkkeen nimi tekstimerkkijonolla. (Valinnainen englanniksi, ei käytetä espanjaksi)
mainSearchCriteria.v.dn = Chantix 0,5 MG oraalinen tabletti
Valinnaiset parametrit
Koodin nimiKun lähetät englanninkielistä tietoa koskevan pyynnön, voit sisällyttää valinnaisen parametrin lääkityksen nimelle. Tämä on yksityiskohtainen edellisessä osassa. mainSearchCriteria.v.dn = Chantix 0,5 MG oraalinen tabletti
Katso edellisestä kohdasta Lähtöparametrit lisätietoja kielestä ja tulostusmuodoista.
Valittujen atomielementtien (tai JSON-objektien) kuvaus vastauksena lääkepyyntöihin
| Elementti | Kuvaus |
|---|---|
| otsikko | Otsikko vastaavalle MedlinePlus-lääkesivulle |
| linkki | Yhteensopivan MedlinePlus-lääkityssivun URL-osoite |
| kirjailija | Lähdemääritelmä lääketiedoille |
Esimerkkejä lääkekoodipyynnöistä
Lääketietopyyntösi pitäisi näyttää yhdeltä seuraavista.
Jos haluat pyytää tietoja RXCUI: lta, pyyntösi tulisi näyttää tältä: 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% 20Oral% 20Tablet & informationRecipient.languageCode.c = fi
Jos haluat pyytää NDC: ltä tietoja espanjankieliselle, pyyntösi tulisi näyttää tältä: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-0751- 39 & informationRecipient.languageCode.c = es
Jos haluat lähettää tekstimerkkijonon ilman lääkekoodia, sinun on tunnistettava kyselysi NDC-tyyppisenä pyynnönä, jotta MedlinePlus Connect tietää etsivän lääketietoja. Tämä toimii vain englanninkielisten pyyntöjen yhteydessä. Pyyntösi saattaa näyttää tältä: 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 = fi
Lab-testitietoja koskevat pyynnöt
MedlinePlus Connect tarjoaa vastaavuuksia laboratoriotestitietoihin, kun se saa LOINC-pyynnön. Palvelu voi antaa vastauksen englanniksi tai espanjaksi.
MedlinePlus Connect -verkkopalvelu palauttaa seuraavat:
Kullekin koodille ei aina välttämättä löydy vastaavuutta. Tällöin MedlinePlus Connect palauttaa tyhjän vastauksen.
Palvelun perus-URL on: https://connect.medlineplus.gov/service
Nämä ovat kaksi vaadittavaa parametria mille tahansa tämän palvelun laboratoriotestikyselylle:
- Koodijärjestelmä
- Tunnista, että käytät LOINC-koodijärjestelmää. Käyttää:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1
- MedlinePlus Connect hyväksyy myös:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79
- Koodi
tunnista todellinen koodi, jota yrität etsiä:
mainSearchCriteria.v.c = 3187-2
Valinnaiset parametrit
Koodin nimiVoit myös tunnistaa laboratoriotestin nimen. Nämä tiedot eivät kuitenkaan vaikuta vastaukseen. mainSearchCriteria.v.dn = tekijä IX -määritys
Katso edellisestä kohdasta Lähtöparametrit lisätietoja kielestä ja tulostusmuodoista.
Valittujen atomielementtien (tai JSON-objektien) kuvaus vastauksena laboratoriotestipyyntöihin
| Elementti | Kuvaus |
|---|---|
| otsikko | Yhteensopivan MedlinePlus-laboratoriotestisivun otsikko |
| linkki | Yhteensopivan MedlinePlus-laboratoriotestisivun URL-osoite |
| yhteenveto | Katkelma sivun sisällöstä |
| kirjailija | Lähdemääritelmä laboratoriotestin sisällölle |
Esimerkkejä laboratoriotestejä koskevista pyynnöistä
Jos haluat pyytää tietoja englanninkieliselle puhelijalle, pyyntösi saattaa näyttää joltakin seuraavista: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = tekijä% 20IX% 20assay & informationRecipient.languageCode.c = fi https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.language = fi
Jos haluat pyytää tietoja espanjankieliselle, pyyntösi saattaa näyttää joltakin seuraavista: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = tekijä% 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
Hyväksyttävää käyttöä koskeva käytäntö
MedlinePlus-palvelinten ylikuormituksen välttämiseksi NLM edellyttää, että MedlinePlus Connect -käyttäjät lähettävät enintään 100 pyyntöä minuutissa IP-osoitetta kohti. Tämän rajan ylittäviin pyyntöihin ei vastata, eikä palvelua palauteta 300 sekunnin ajaksi tai ennen kuin pyyntöaste laskee rajan alle, kumpi tulee myöhemmin. Connectille lähettämiesi pyyntöjen määrän rajoittamiseksi NLM suosittelee välimuistituloksia 12–24 tunnin ajaksi.
Tämän käytännön avulla varmistetaan, että palvelu on edelleen kaikkien käyttäjien käytettävissä. Jos sinulla on erityinen käyttötapaus, joka edellyttää, että lähetät suuren määrän pyyntöjä MedlinePlus Connect -palveluun ja ylität täten tässä käytännössä määritetyn pyyntimäärän rajan, ota meihin yhteyttä. NLM: n henkilökunta arvioi pyyntösi ja päättää, voidaanko poikkeus myöntää. Tutustu myös MedlinePlus XML-tiedostojen dokumentaatioon. Nämä XML-tiedostot sisältävät täydelliset terveysaiheiset tietueet ja voivat toimia vaihtoehtoisena tapana käyttää MedlinePlus-tietoja.
Lisää tietoa
Suosittu
Labyrinthitis 7 pääoireita
