MedlinePlus Connect: tīmekļa pakalpojums
Saturs
- Tīmekļa pakalpojumu pārskats
- Izejas parametri
- Pieprasījumi pēc diagnostikas (problēmu) kodiem
- Izvēles parametri
- Atlasīto atomu elementu (vai JSON objektu) apraksts, atbildot uz problēmu koda pieprasījumiem
- Problēmu kodu pieprasījumu piemēri
- Saistītie pakalpojumi un faili
- Pieprasījumi pēc informācijas par narkotikām
- Izvēles parametri
- Atlasīto atomu elementu (vai JSON objektu) apraksts, atbildot uz zāļu pieprasījumiem
- Zāļu kodu pieprasījumu piemēri
- Laboratorijas informācijas informācijas pieprasījumi
- Izvēles parametri
- Atlasīto atomu elementu (vai JSON objektu) apraksts atbildē uz laboratorijas testa pieprasījumiem
- Laboratorijas testu pieprasījumu piemēri
- Pieņemamas lietošanas politika
- Vairāk informācijas
MedlinePlus Connect ir pieejams kā tīmekļa lietojumprogramma vai tīmekļa pakalpojums. Tālāk ir sniegta tehniskā informācija tīmekļa pakalpojuma ieviešanai, kas atbild uz pieprasījumiem, pamatojoties uz:
Laipni aicināti saistīt un parādīt MedlinePlus Connect atgrieztos datus. Jūs nedrīkstat kopēt MedlinePlus lapas savā vietnē. Ja izmantojat datus no MedlinePlus Connect tīmekļa pakalpojuma, lūdzu, norādiet, ka informācija ir no MedlinePlus.gov, taču nelietojiet MedlinePlus logotipu vai citādi norādiet, ka MedlinePlus atbalsta jūsu konkrēto produktu. Lūdzu, skatiet NLM API lapu, lai saņemtu papildu norādījumus. Lai iegūtu papildinformāciju par to, kā saistīt ar MedlinePlus saturu ārpus šī pakalpojuma, lūdzu, skatiet mūsu vadlīnijas un norādījumus par saistīšanu.
Ja jūs nolemjat izmantot MedlinePlus Connect, reģistrējieties e-pasta sarakstam, lai sekotu jaunumiem un apmainītos ar idejām ar saviem kolēģiem. Lūdzu, pastāstiet mums, vai esat ieviesis MedlinePlus Connect, sazinoties ar mums.
Tīmekļa pakalpojumu pārskats
Web servisa pieprasījumu parametri atbilst HL7 konteksta apzināšanās zināšanu atgūšanas (informācijas pogas) zināšanu pieprasījuma URL balstītas ieviešanas rokasgrāmatai. Uz REST balstītā atbilde atbilst HL7 Context-Aware Knowledge Retrieval (Infobutton) uz pakalpojumu orientētās arhitektūras ieviešanas rokasgrāmatai. Pieprasījuma izeja var būt XML Atom plūsmas formātā, JSON vai JSONP.
Pieprasījuma struktūra norāda, kāda veida kodu jūs sūtāt. Visos gadījumos tīmekļa pakalpojuma pamata URL ir: https://connect.medlineplus.gov/service
MedlinePlus Connect izmanto HTTPS savienojumus. HTTP pieprasījumi netiks pieņemti, un esošajām ieviešanām, kurās tiek izmantots HTTP, jāatjauninās uz HTTPS.
Izejas parametri
Šie parametri nav obligāti. Ja jūs tos neatstājat, noklusējuma atbilde ir informācija angļu valodā XML formātā.
Valoda
Norādiet, vai vēlaties, lai atbilde būtu angļu vai spāņu valodā. MedlinePlus Connect pieņems, ka valoda ir angļu valoda, ja tā nav norādīta.
Ja vēlaties, lai atbilde uz problēmu koda meklēšanu būtu spāņu valodā, izmantojiet: informationRecipient.languageCode.c = es
(= pieņemts arī sp)
Lai norādītu angļu valodu, izmantojiet šo: informationRecipient.languageCode.c = lv
Formāts
Norādiet, vai vēlaties, lai atbildes formāts būtu XML, JSON vai JSONP. XML ir noklusējums.
- Lai pieprasītu JSON, izmantojiet:
- knowledgeResponseType = pieteikums / json
- JSONP izmantojiet:
- knowledgeResponseType = application / javascript & callback = CallbackFunction, kur CallbackFunction ir nosaukums, kuru piešķirat atzvanīšanas funkcijai.
- Lai saņemtu atbildi XML formātā, izmantojiet:
- zināšanasResponseType = text / xml vai atstājiet parametru knowResponseType ārpus pieprasījuma.
Pieprasījumi pēc diagnostikas (problēmu) kodiem
Lai iegūtu problēmu kodu, MedlinePlus Connect atgriezīs saites un informāciju no MedlinePlus veselības tēmu lapām, ģenētikas lapām vai citu NIH institūtu lapām.
MedlinePlus Connect atgriezīs:
Katram kodam ne vienmēr var būt atbilstība. Šādos gadījumos MedlinePlus Connect atgriezīs nulles atbildi.
Pakalpojuma pamata URL ir: https://connect.medlineplus.gov/service
Jebkuram šī pakalpojuma vaicājumam ir divi nepieciešamie parametri:
- Kodu sistēma
Identificējiet problēmu kodu sistēmu, kuru izmantosiet.- ICD-10-CM lietošanai:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90
- ICD-9-CM lietošanai:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103
- SNOMED CT lietošanai:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96
- Kods
Identificējiet faktisko kodu, kuru mēģināt meklēt:
mainSearchCriteria.v.c = 250,33
Izvēles parametri
Kods Nosaukums
Jūs varat arī identificēt problēmas koda nosaukumu / nosaukumu. Tomēr šī informācija neietekmē atbildi (atšķirībā no tīmekļa lietojumprogrammas MedlinePlus Connect, kurā var izmantot informāciju par nosaukumu / nosaukumu). mainSearchCriteria.v.dn = Cukura diabēts ar citu 1. tipa komu nekontrolētu. Sīkāku informāciju par valodu un izvades formātiem skatiet iepriekšējā sadaļā Par izvades parametriem
Atlasīto atomu elementu (vai JSON objektu) apraksts, atbildot uz problēmu koda pieprasījumiem
| Elements | Klases mezgls | Apraksts |
|---|---|---|
| nosaukums | Saskaņotās MedlinePlus veselības tēmas lapas vai GHR lapas nosaukums | |
| saite | URL atbilstošajai MedlinePlus veselības tēmas lapai vai GHR lapai | |
| kopsavilkums | Pilns veselības tēmas kopsavilkums. Tas ietver iegultas saites uz citām atbilstošām veselības tēmām un visu formatējumu, ieskaitot aizzīmes un atstarpes starp rindkopām. Kopsavilkums ir HTML. GHR lapām ir paredzēta pilnas lapas pirmā sadaļa. | |
| kopsavilkums | Tēmas sinonīmi. Veselības tēmas lapā tie tiek saukti par “Saukti arī”. Ne visās tēmās ir termini "Saukti arī". | |
| kopsavilkums | Attiecinājuma apstiprinājums kopsavilkuma tekstam, ja lielākā daļa kopsavilkuma bija no citas federālās aģentūras. Ne visiem kopsavilkumiem ir attiecinājums. Nepiešķirts teksts ir oriģināls uzņēmumam MedlinePlus. | |
| kopsavilkums | Atlasītās saites, kas saistītas ar tēmu. Tas ietver lapas nosaukumu, URL un saistīto organizāciju (ja piemērojams). Saites tiek formatētas aizzīmētu sarakstā. Ne visām tēmām ir šīs saites. Saites var svārstīties no nulles līdz desmitiem. |
Problēmu kodu pieprasījumu piemēri
Pilnīgam pieprasījumam pēc cukura diabēta ar citu 1. tipa koma nekontrolētu, ICD-9 kodu 250.33 spāniski runājošam pacientam būtu šāda URL adrese: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103 & mainSearchCriteria.vc = 250.33 & mainSearchCriteria.v.dn = Diabēts% 20mellitus% 20with% 20other% 20coma% 20type% 201% 20oncontrolled & informationRecipient.languageCode.c = es
Pacientam ar tādu pašu diagnozi, bet pieprasītais formāts ir JSON un valoda ir angļu: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application / json
Pacientam, kam diagnosticēta "Pneimonija Pseudomonas dēļ", izmantojot SNOMED CT kodu 41381004: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v.dn= Pneimonija% 20due% 20to% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.languageCode.c = lv
Pacients ar tādu pašu diagnozi, bet pieprasītais formāts ir JSONP: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javascript&callback=
Saistītie pakalpojumi un faili
Lai saņemtu MedlinePlus veselības tēmas, atbildot uz teksta pieprasījumiem, nevis problēmu kodiem, izpētiet MedlinePlus tīmekļa pakalpojumu. Turklāt, ja jums ir nepieciešams pilns MedlinePlus veselības tēmu komplekts XML formātā, skatiet mūsu lapu XML faili.
Pieprasījumi pēc informācijas par narkotikām
MedlinePlus Connect nodrošina vislabāko informāciju par narkotikām, saņemot RXCUI. Tas arī nodrošina labus rezultātus, saņemot NDC kodu. MedlinePlus Connect var sniegt atbildes angļu vai spāņu valodā.
Ja pieprasāt informāciju par medikamentiem angļu valodā, ja nesūtāt NDC vai RXCUI vai ja mēs neatrodam atbilstību, pamatojoties uz kodu, lietojumprogramma izmantos jūsu nosūtītās teksta virknes, lai parādītu vislabāko zāļu informācijas atbilstību. Pieprasījumiem saņemt informāciju par spāņu medikamentiem MedlinePlus Connect atbild tikai uz NDC vai RXCUI un neizmanto teksta virknes. Ir iespējams saņemt atbildi angļu valodā, bet spāņu valodā nav atbildes.
MedlinePlus Connect tīmekļa pakalpojums atgriezīs:
Uz vienu zāļu pieprasījumu varētu būt vairākas atbildes. Katram pieprasījumam ne vienmēr var būt atbilstība. Šādos gadījumos MedlinePlus Connect atgriezīs nulles atbildi.
Pieprasījumiem par narkotiku informāciju pamata URL ir: https://connect.medlineplus.gov/service
Lai nosūtītu pieprasījumu, iekļaujiet šo informāciju:
- Kodu sistēma
Nosakiet nosūtītā medikamenta koda veidu. (Obligāti angļu un spāņu valodā)- RXCUI lietošanai:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88
- NDC lietošanai:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69
- Kods
Nosakiet faktisko kodu, kuru mēģināt meklēt. (Vēlams angļu valodai, obligāts spāņu valodā)
mainSearchCriteria.v.c = 637188 - Zāļu nosaukums
Ar teksta virkni identificējiet zāļu nosaukumu. (Pēc izvēles angļu valodā, spāņu valodā neizmanto)
mainSearchCriteria.v.dn = Chantix 0,5 MG iekšķīgi lietojama tablete
Izvēles parametri
Kods NosaukumsSūtot informācijas pieprasījumu angļu valodā, jūs varat iekļaut izvēles parametru zāļu nosaukumam. Tas ir sīki aprakstīts iepriekšējā sadaļā. mainSearchCriteria.v.dn = Chantix 0,5 MG iekšķīgi lietojama tablete
Skatiet iepriekšējo sadaļu par izvades parametriem, lai iegūtu sīkāku informāciju par valodu un izvades formātiem.
Atlasīto atomu elementu (vai JSON objektu) apraksts, atbildot uz zāļu pieprasījumiem
| Elements | Apraksts |
|---|---|
| nosaukums | Nosaukums atbilstošajai MedlinePlus zāļu lapai |
| saite | URL atbilstošajai MedlinePlus zāļu lapai |
| autors | Avota attiecināšana uz informāciju par medikamentiem |
Zāļu kodu pieprasījumu piemēri
Jūsu zāļu informācijas pieprasījumam vajadzētu izskatīties kā viens no šiem.
Lai pieprasītu informāciju, izmantojot RXCUI, jūsu pieprasījumam vajadzētu izskatīties šādi: 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 = lv
Lai NDC pieprasītu informāciju spāņu valodā runājošam, jūsu pieprasījumam vajadzētu izskatīties šādi: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-0751- 39 & informationRecipient.languageCode.c = es
Lai nosūtītu teksta virkni bez zāļu koda, vaicājums jāidentificē kā NDC tipa pieprasījums, lai MedlinePlus Connect zinātu, ka meklējat informāciju par medikamentiem. Tas darbosies tikai angļu valodas pieprasījumiem. Jūsu pieprasījums varētu izskatīties šādi: 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 = lv
Laboratorijas informācijas informācijas pieprasījumi
MedlinePlus Connect, saņemot LOINC pieprasījumu, nodrošina atbilstību laboratorijas testu informācijai. Pakalpojums var sniegt atbildi angļu vai spāņu valodā.
MedlinePlus Connect tīmekļa pakalpojums atgriezīs:
Katram kodam ne vienmēr var būt atbilstība. Šādos gadījumos MedlinePlus Connect atgriezīs nulles atbildi.
Pakalpojuma pamata URL ir: https://connect.medlineplus.gov/service
Šie ir divi nepieciešamie parametri jebkuram šī pakalpojuma laboratorijas testa vaicājumam:
- Kodu sistēma
- Identificējiet, ka izmantojat LOINC kodu sistēmu. Izmantojiet:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1
- MedlinePlus Connect pieņems arī:
- mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79
- Kods
identificējiet faktisko kodu, kuru mēģināt meklēt:
mainSearchCriteria.v.c = 3187-2
Izvēles parametri
Kods NosaukumsJūs varat arī noteikt laboratorijas testa nosaukumu. Tomēr šī informācija neietekmē atbildi. mainSearchCriteria.v.dn = IX faktora tests
Skatiet iepriekšējo sadaļu par izvades parametriem, lai iegūtu sīkāku informāciju par valodu un izvades formātiem.
Atlasīto atomu elementu (vai JSON objektu) apraksts atbildē uz laboratorijas testa pieprasījumiem
| Elements | Apraksts |
|---|---|
| nosaukums | Atbilstošās MedlinePlus laboratorijas testa lapas nosaukums |
| saite | URL atbilstošajai MedlinePlus laboratorijas testa lapai |
| kopsavilkums | Fragments no lapas satura |
| autors | Avota attiecinājums laboratorijas testa saturam |
Laboratorijas testu pieprasījumu piemēri
Lai pieprasītu informāciju angļu valodā runājošam, jūsu pieprasījums var izskatīties kā viens no šiem: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = faktors% 20IX% 20assay & informationRecipient.languageCode.c = lv https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.language = lv
Lai pieprasītu informāciju spāņu valodas runātājam, jūsu pieprasījums var izskatīties kā viens no šiem: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = faktors% 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
Pieņemamas lietošanas politika
Lai izvairītos no MedlinePlus serveru pārslodzes, NLM pieprasa, lai MedlinePlus Connect lietotāji uz IP adresi sūtītu ne vairāk kā 100 pieprasījumus minūtē. Pieprasījumi, kas pārsniedz šo ierobežojumu, netiks apkalpoti, un apkalpošana netiks atjaunota 300 sekundes vai līdz brīdim, kad pieprasījumu līmenis nokritīsies zem limita, atkarībā no tā, kurš nosacījums notiks vēlāk. Lai ierobežotu Connect nosūtīto pieprasījumu skaitu, NLM iesaka saglabāt kešatmiņā 12–24 stundu periodu.
Šī politika ir ieviesta, lai nodrošinātu, ka pakalpojums joprojām ir pieejams un pieejams visiem lietotājiem. Ja jums ir īpašs lietošanas gadījums, kas liek jums nosūtīt lielu skaitu pieprasījumu uz MedlinePlus Connect un tādējādi pārsniedz šajā politikā noteikto pieprasījumu līmeņa ierobežojumu, lūdzu, sazinieties ar mums. NLM darbinieki novērtēs jūsu pieprasījumu un noteiks, vai var piešķirt izņēmumu. Lūdzu, pārskatiet arī MedlinePlus XML failu dokumentāciju. Šie XML faili satur pilnīgus veselības tēmas ierakstus un var kalpot kā alternatīva metode piekļuvei MedlinePlus datiem.
Vairāk informācijas
Nesenie Raksti
Jūties kā “slikta” persona? Uzdodiet sev šos jautājumus
