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:
- 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
- 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:
- 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
- Kód
Határozza meg a tényleges kódot, amelyet keresni szeretne. (Angol nyelven preferált, spanyolul kötelező)
mainSearchCriteria.v.c = 637188 - 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
Opcionális paraméterek
Kód címeAngol 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:
- 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
- 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ímeMegadhatja 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ó
Neked
Spondyloarthritis: Amit tudnia kell
