MedlinePlus Connect: webszolgáltatás

Tartalom

• Webszolgáltatás áttekintése
• Kimeneti paraméterek
• Diagnosztikai (probléma) kódok iránti kérelmek
• Opcionális paraméterek
• A kiválasztott atomelemek (vagy JSON-objektumok) leírása a válaszként a problémakód-kérelmekre
• Példák a problémakódok iránti kérelmekre
• Kapcsolódó szolgáltatások és fájlok
• Kábítószer-információk iránti kérelmek
• Opcionális paraméterek
• A kiválasztott atom elemek (vagy JSON objektumok) leírása a gyógyszeres kérésekre adott válaszban
• Példák a kábítószer-kódok iránti kérelmekre
• Laboratóriumi vizsgálati információkra vonatkozó kérések
• Opcionális paraméterek
• A kiválasztott atomelemek (vagy JSON-objektumok) leírása a laboratóriumi tesztkérelmekre adott válaszban
• Példák laboratóriumi vizsgálatokra
• Elfogadható használati irányelv
• Több információ

A MedlinePlus Connect webalkalmazásként vagy webszolgáltatásként érhető el. Az alábbiakban bemutatjuk a webes szolgáltatás megvalósításának technikai részleteit, amely a kérésekre válaszol:

Örömmel linkelheti és megjelenítheti a MedlinePlus Connect által visszaküldött adatokat. Nem másolhatja a MedlinePlus oldalakat a webhelyére. Ha a MedlinePlus Connect webszolgáltatás adatait használja, kérjük, jelezze, hogy az információk a MedlinePlus.gov-tól származnak, de ne használja a MedlinePlus logót, vagy más módon utaljon arra, hogy a MedlinePlus támogatja az adott terméket. További útmutatásért olvassa el az NLM API oldalát. A MedlinePlus tartalom ezen a szolgáltatáson kívüli linkelésével kapcsolatos további információkért tekintse meg a linkelésre vonatkozó irányelveinket és utasításokat.

Ha a MedlinePlus Connect használata mellett dönt, regisztráljon az e-mail listára, hogy lépést tartson a fejleményekkel és ötleteket cseréljen kollégáival. Kérjük, közölje velünk, ha a MedlinePlus Connect alkalmazást használja.

Webszolgáltatás áttekintése

A webszolgáltatási kérelmek paraméterei megfelelnek a HL7 kontextus-tudatú tudáskeresés (infobutton) tudásigény URL-alapú megvalósítási útmutatójának. A REST-alapú válasz megfelel a HL7 Context-Aware Knowledge Retrieval (Infobutton) szolgáltatás-orientált architektúra megvalósítási útmutatójának. A kérelem kimenete XML lehet Atom feed formátumban, JSON vagy JSONP.

A kérelem felépítése jelzi, hogy milyen típusú kódot küld. A webszolgáltatás alap URL-je minden esetben a következő: https://connect.medlineplus.gov/service

A MedlinePlus Connect HTTPS kapcsolatokat használ. A HTTP kéréseket nem fogadjuk el, és a HTTP-t használó meglévő megvalósításoknak HTTPS-re kell frissülniük.

Kimeneti paraméterek

Ezek a paraméterek nem kötelezőek. Ha kihagyja őket, az alapértelmezett válasz az angol információ XML formátumban.

Nyelv
Határozza meg, hogy szeretné-e a választ angolul vagy spanyolul adni. A MedlinePlus Connect feltételezi, hogy az angol a nyelv, ha nincs megadva.

Ha azt szeretné, hogy a problémakód keresésére spanyol nyelven válaszoljon, használja: informationRecipient.languageCode.c = es
(= sp is elfogadott)

Az angol megadásához használja a következőket: informationRecipient.languageCode.c = hu

Formátum
Határozza meg, hogy szeretné-e a válasz formátumát XML, JSON vagy JSONP formátumban használni. Az XML az alapértelmezett.

A JSON igényléséhez használja:

knowledgeResponseType = alkalmazás / json

A JSONP esetében használja:

knowledgeResponseType = application / javascript & callback = CallbackFunction, ahol a CallbackFunction egy név, amelyet a visszahívási funkciónak ad meg.

XML-ben történő válaszhoz használja:

knowledgeResponseType = text / xml, vagy hagyja a knowResponseType paramétert a kérésből.

Diagnosztikai (probléma) kódok iránti kérelmek

Problémakód esetén a MedlinePlus Connect visszaküldi a MedlinePlus egészségügyi témájú, genetikai vagy más NIH intézetek oldalairól származó linkeket és információkat.

A MedlinePlus Connect a következőket adja vissza:

Előfordulhat, hogy nem mindig egyezik minden kód. Ezekben az esetekben a MedlinePlus Connect null választ ad vissza.

A szolgáltatás alap URL-je: https://connect.medlineplus.gov/service

A szolgáltatás bármely lekérdezéséhez két szükséges paraméter szükséges:

1. Kódrendszer
   Határozza meg a használni kívánt problémakódrendszert.

   ICD-10-CM használatra:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90

   ICD-9-CM használatra:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103

   SNOMED CT esetén:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96

2. Kód
   Határozza meg a tényleges kódot, amelyet keresni szeretne:
   mainSearchCriteria.v.c = 250.33

Opcionális paraméterek

Kód címe
Megadhatja a problémakód nevét / címét is. Ez az információ azonban nem befolyásolja a választ (ellentétben a MedlinePlus Connect webalkalmazással, ahol a név / cím információ használható). mainSearchCriteria.v.dn = Cukorbetegség más, 1. típusú kómával nem kontrolláltan A nyelvi és kimeneti formátumok részleteit lásd a Kimeneti paraméterek fenti részben.

A kiválasztott atomelemek (vagy JSON-objektumok) leírása a válaszként a problémakód-kérelmekre

Elem	Osztály csomópont	Leírás
cím		Az egyező MedlinePlus egészségügyi témakör vagy GHR oldal címe
link		URL a MedlinePlus egészségügyi témakörhöz vagy a GHR-oldalhoz
összefoglaló		Az egészségügyi téma teljes összefoglalója. Ez magában foglalja a beágyazott hivatkozásokat más releváns egészségügyi témákra, és minden formázást, beleértve a felsorolásjeleket és a bekezdéstávolságot. Az összefoglaló HTML-ben található. A GHR oldalak esetében a teljes oldal első szakasza található.
összefoglaló		A téma szinonimái. Ezeket "más néven" nevezik egy egészségügyi témájú oldalon. Nem minden témában vannak "más néven" kifejezések.
összefoglaló		Az összefoglaló szöveg hozzárendelésének nyugtázása, ha az összefoglaló többsége egy másik szövetségi ügynökségtől származik. Nem minden összefoglaló rendelkezik attribútummal. A hozzárendelés nélküli szöveg eredeti a MedlinePlus számára.
összefoglaló		A témához társított kiválasztott linkek. Ez magában foglalja az oldal nevét, URL-jét és a társított szervezetet (ha alkalmazható). A hivatkozások felsorolással ellátott listában vannak megadva. Nem minden témakör rendelkezik ilyen linkekkel. A linkek száma nullától tucatig terjedhet.

Példák a problémakódok iránti kérelmekre

A Diabetes Mellitus más, 1. típusú kómás kontroll nélküli, ICD-9 kóddal (250.33) kapcsolatos teljes kérelme spanyol nyelvű beteg számára a következő URL-címmel rendelkezik: 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

Azonos diagnózissal rendelkező, de a kért formátumú beteg JSON, a nyelv pedig angol: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application / json

A 41381004 SNOMED CT kódot használó "Pneudonia Pseudomonas miatt" diagnosztizált beteg: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v.dn= Tüdőgyulladás% 20due% 20to% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.languageCode.c = hu

Azonos diagnózissal rendelkező, de a kért formátumú beteg JSONP: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javascript&callback=

Kapcsolódó szolgáltatások és fájlok

Ha a MedlinePlus egészségügyi témákat szeretné megkapni szöveges kérésekre válaszolva, a problémakódokkal szemben, vizsgálja meg a MedlinePlus webszolgáltatást. Továbbá, ha szüksége van a MedlinePlus egészségügyi témák teljes készletére XML formátumban, tekintse meg az XML fájlok oldalt.

Kábítószer-információk iránti kérelmek

A MedlinePlus Connect biztosítja a legjobb gyógyszerinformációs egyezéseket, amikor RXCUI-t kap. NDC kód fogadásakor is jó eredményeket nyújt. A MedlinePlus Connect angol vagy spanyol válaszokat adhat.

Az angol gyógyszeres információkkal kapcsolatos kérelmek esetén, ha nem küld NDC-t vagy RXCUI-t, vagy ha a kód alapján nem találunk egyezést, akkor az alkalmazás az Ön által küldött szöveges karakterláncot használja a legjobb gyógyszerinformációs egyezés megjelenítésére. Spanyol gyógyszeradatokkal kapcsolatos kérelmek esetén a MedlinePlus Connect csak az NDC-kre vagy az RXCUI-kre válaszol, és nem használ szöveges karakterláncokat. Lehetséges, hogy válaszoljon angolul, de spanyolul nem.

A MedlinePlus Connect webszolgáltatás a következőket adja vissza:

Egy gyógyszeres kérelemre több válasz is érkezhet. Előfordulhat, hogy nem mindig van egyezés minden egyes kéréshez. Ezekben az esetekben a MedlinePlus Connect null választ ad vissza.

A kábítószer-információkkal kapcsolatos kérelmek esetén az alap URL a következő: https://connect.medlineplus.gov/service

Kérelem elküldéséhez adja meg ezeket az információkat:

1. Kódrendszer
   Határozza meg a küldött gyógyszerkód típusát. (Angol és spanyol nyelvhez szükséges)
   

   RXCUI használatra:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88

   NDC használatra:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69

   A MedlinePlus Connect szöveges karaktersorozatot is elfogadhat a gyógyszeres információkkal kapcsolatos angol nyelvű kérésekhez, de a fent felsorolt ​​két kódrendszer egyikének beillesztésével be kell jelentenie, hogy gyógyszerekkel kapcsolatos információkat keres.
2. Kód
   Határozza meg a tényleges kódot, amelyet keresni szeretne. (Angol nyelven preferált, spanyolul kötelező)
   mainSearchCriteria.v.c = 637188
3. Gyógyszer neve
   Azonosítsa a gyógyszer nevét szöveges karakterlánccal. (Angolként választható, spanyolul nem használható)
   mainSearchCriteria.v.dn = Chantix 0,5 MG szájon át szedett tabletta

Legalább meg kell határoznia a kódrendszert és a kódot, vagy a kódrendszert és a gyógyszer nevét. Küldje el mind a hármat az angol kérések legjobb eredményeinek elérése érdekében. Küldje el a kódrendszert és a spanyol kérések kódját.

Opcionális paraméterek

Kód címe

Angol információra vonatkozó kérés küldésekor megadhatja a gyógyszer nevének opcionális paraméterét. Ezt a fenti szakasz részletezi. mainSearchCriteria.v.dn = Chantix 0,5 MG szájon át szedett tabletta

A nyelv és a kimeneti formátumok részleteit lásd a kimeneti paraméterek fenti szakaszában.

A kiválasztott atom elemek (vagy JSON objektumok) leírása a gyógyszeres kérésekre adott válaszban

Elem	Leírás
cím	A megfelelő MedlinePlus gyógyszeroldal címe
link	Az egyeztetett MedlinePlus gyógyszeres oldal URL-je
szerző	Forrás hozzárendelés a gyógyszerekkel kapcsolatos információkhoz

Példák a kábítószer-kódok iránti kérelmekre

A gyógyszerekkel kapcsolatos információkérésének az alábbiak egyikének kell kinéznie.

Ha információt szeretne kérni egy RXCUI által, akkor a kérésének a következőképpen kell kinéznie: 200,5% 20MG% 20Oral% 20Tablet & informationRecipient.languageCode.c = hu

Ha információt szeretne kérni egy NDC-től egy spanyol nyelvű beszélő számára, akkor a következőképpen kell kinéznie: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-0751- 39 & informationRecipient.languageCode.c = es

Ha szöveges karakterláncot szeretne elküldeni gyógyszerkód nélkül, akkor a lekérdezést NDC típusú kérésként kell azonosítania, hogy a MedlinePlus Connect tudja, hogy gyógyszeres információkat keres. Ez csak angol kérések esetén működik. Kérése így nézhet ki: 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 = hu

Laboratóriumi vizsgálati információkra vonatkozó kérések

A MedlinePlus Connect egyezéseket biztosít a laboratóriumi vizsgálati adatokkal, amikor LOINC kérést kap. A szolgáltatás angol vagy spanyol nyelven adhat választ.

A MedlinePlus Connect webszolgáltatás a következőket adja vissza:

Előfordulhat, hogy nem mindig egyezik minden kód. Ezekben az esetekben a MedlinePlus Connect null választ ad vissza.

A szolgáltatás alap URL-je: https://connect.medlineplus.gov/service

A szolgáltatás minden laboratóriumi lekérdezéséhez két szükséges paraméter szükséges:

1. Kódrendszer
   

   Ellenőrizze, hogy a LOINC kódrendszert használja-e. Használat:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1

   A MedlinePlus Connect az alábbiakat is elfogadja:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79

2. Kód
   azonosítsa a tényleges kódot, amelyet megpróbál keresni:
   mainSearchCriteria.v.c = 3187-2

Opcionális paraméterek

Kód címe

Megadhatja a laborvizsgálat nevét is. Ez az információ azonban nem befolyásolja a választ. mainSearchCriteria.v.dn = IX. faktor vizsgálat

A nyelv és a kimeneti formátumok részleteit lásd a kimeneti paraméterek fenti szakaszában.

A kiválasztott atomelemek (vagy JSON-objektumok) leírása a laboratóriumi tesztkérelmekre adott válaszban

Elem	Leírás
cím	Az egyező MedlinePlus laboratóriumi teszt címe
link	URL az egyeztetett MedlinePlus laboratóriumi oldalhoz
összefoglaló	Részlet az oldal tartalmából
szerző	Forrás hozzárendelés a laboratóriumi teszt tartalmához

Példák laboratóriumi vizsgálatokra

Ha információt szeretne kérni egy angol nyelvű beszélőhöz, akkor az Ön kérése az alábbiak egyikének tűnhet: 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 = hu https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.language = hu

Ha információt szeretne kérni egy spanyol nyelvű beszélő számára, akkor az Ön kérése az alábbiak egyikének nézhet ki: 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

Elfogadható használati irányelv

A MedlinePlus szerverek túlterhelésének elkerülése érdekében az NLM megköveteli, hogy a MedlinePlus Connect felhasználói IP-címenként percenként legfeljebb 100 kérést küldjenek. Az ezt a korlátot túllépő kérelmek nem kerülnek kiszolgálásra, és a szolgáltatás nem áll helyre 300 másodpercig, vagy addig, amíg az igénylési arány nem esik a határérték alá, attól függően, hogy melyik következik be később. A Connect számára küldött kérelmek számának korlátozása érdekében az NLM 12–24 órás időszakos gyorsítótárazási eredményeket javasol.

Ez a házirend annak biztosítására szolgál, hogy a szolgáltatás továbbra is elérhető és elérhető legyen minden felhasználó számára. Ha olyan speciális esete van, amely miatt nagyszámú kérést kell elküldenie a MedlinePlus Connect számára, és így túllépi az ebben a házirendben meghatározott kérési arányhatárt, kérjük, lépjen kapcsolatba velünk. Az NLM munkatársai értékelik az Ön kérését, és megállapítják, hogy adható-e kivétel. Kérjük, olvassa el a MedlinePlus XML fájlok dokumentációját is. Ezek az XML fájlok teljes egészségügyi témaköröket tartalmaznak, és alternatív módszerként szolgálhatnak a MedlinePlus adatok eléréséhez.

Több információ