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:

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

2. 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:

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

   MedlinePlus Connect var arī pieņemt teksta virkni informācijas pieprasījumiem par medikamentiem angļu valodā, taču jums jānorāda, ka meklējat informāciju par medikamentiem, iekļaujot vienu no divām iepriekš uzskaitītajām kodu sistēmām.
2. Kods
   Nosakiet faktisko kodu, kuru mēģināt meklēt. (Vēlams angļu valodai, obligāts spāņu valodā)
   mainSearchCriteria.v.c = 637188
3. 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

Jums vismaz jāidentificē kodu sistēma un kods, vai kodu sistēma un zāļu nosaukums. Lai iegūtu labākos rezultātus par angļu valodas pieprasījumiem, nosūtiet visus trīs. Nosūtiet kodu sistēmu un Spānijas pieprasījumu kodu.

Izvēles parametri

Kods Nosaukums

Sū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:

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

2. Kods
   identificējiet faktisko kodu, kuru mēģināt meklēt:
   mainSearchCriteria.v.c = 3187-2

Izvēles parametri

Kods Nosaukums

Jū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