MedlinePlus Connect: Shërbim Uebi

Përmbajtje

• Përmbledhje e Shërbimit të Uebit
• Parametrat e daljes
• Kërkesat për Kodet e Diagnostikimit (Problemit)
• Parametrat opsionalë
• Përshkrimi i Elementeve të Zgjedhura të Atomit (ose objekteve JSON) në përgjigje të kërkesave të kodit të problemit
• Shembuj të kërkesave për kodet e problemit
• Shërbimet dhe skedarët e lidhur
• Kërkesat për informacionin mbi ilaçet
• Parametrat opsionalë
• Përshkrimi i Elementeve të Zgjedhura të Atomit (ose objekteve JSON) në përgjigje të kërkesave të ilaçeve
• Shembuj të kërkesave për kodet e ilaçeve
• Kërkesat për Informacionin e Testit të Laboratorit
• Parametrat opsionalë
• Përshkrimi i Elementeve të Zgjedhura të Atomit (ose objekteve JSON) në përgjigje të kërkesave të Testit të Laboratorit
• Shembuj të kërkesave për testet laboratorike
• Politika e pranueshme e përdorimit
• Më shumë informata

MedlinePlus Connect është në dispozicion si një aplikacion në internet ose shërbim Web. Më poshtë janë detajet teknike për zbatimin e shërbimit Web, i cili u përgjigjet kërkesave bazuar në:

Jeni të mirëpritur të lidhni dhe të shfaqni të dhënat e kthyera nga MedlinePlus Connect. Ju nuk mund të kopjoni faqet e MedlinePlus në faqen tuaj. Nëse përdorni të dhëna nga Shërbimi Ueb i Lidhjes MedlinePlus, ju lutemi tregoni se informacioni është nga MedlinePlus.gov por mos përdorni logon e MedlinePlus ose përndryshe nënkuptoni që MedlinePlus miraton produktin tuaj të veçantë. Ju lutemi shikoni faqen e API-së së NLM për udhëzime të mëtejshme. Për më shumë informacion se si të lidheni me përmbajtjen e MedlinePlus jashtë këtij shërbimi, ju lutemi shikoni udhëzimet dhe udhëzimet tona për lidhjen.

Nëse vendosni të përdorni MedlinePlus Connect, regjistrohuni në listën e postës elektronike për të vazhduar me zhvillimet dhe për të shkëmbyer ide me kolegët tuaj. Ju lutemi na tregoni nëse zbatoni MedlinePlus Connect duke na kontaktuar.

Përmbledhje e Shërbimit të Uebit

Parametrat për kërkesat e shërbimit të Uebit përputhen me Udhëzuesin e Zbatimit të Kërkesës së Njohurisë për Kërkesën e Njohurisë HL7 Context-Aware Knowledge (Infobutton). Përgjigja e bazuar në REST përputhet me Udhëzuesin për Zbatimin e Arkitekturës Orientuar tek Shërbimi HL7 Context-Aware Knowledge Retrieval (Infobutton). Rezultati i kërkesës mund të jetë XML në formatin e furnizimit të Atomit, JSON ose JSONP.

Struktura e kërkesës tregon se çfarë lloji të kodit po dërgoni. Në të gjitha rastet, URL-ja bazë për shërbimin në internet është: https://connect.medlineplus.gov/service

MedlinePlus Connect përdor lidhjet HTTPS. Kërkesat HTTP nuk do të pranohen dhe implementimet ekzistuese duke përdorur HTTP duhet të azhurnohen në HTTPS.

Parametrat e daljes

Këto parametra janë opsionale. Nëse i lini jashtë, përgjigjja e paracaktuar është informacioni anglez në formatin XML.

Gjuhe
Identifikoni nëse dëshironi që përgjigjja të jetë në Anglisht ose Spanjisht. MedlinePlus Connect do të supozojë se anglishtja është gjuha nëse nuk është specifikuar.

Nëse dëshironi që përgjigja për kërkimin e kodit të problemit të jetë në Spanjisht, përdorni: informationRecipient.languageCode.c = es
(= sp gjithashtu pranohet)

Për të specifikuar anglisht, përdorni sa vijon: informationRecipient.languageCode.c = sq

Formati
Identifikoni nëse dëshironi që formati i përgjigjes të jetë XML, JSON ose JSONP. XML është e paracaktuar.

Për të kërkuar JSON, përdorni:

knowledgeResponseType = aplikimi / json

Për JSONP, përdorni:

knowledgeResponseType = application / javascript & callback = CallbackFunction ku CallbackFunction është një emër që ju jepni funksionin e kthimit të thirrjes.

Për një përgjigje në XML, përdorni:

knowledgeResponseType = teksti / xml ose lini parametrin e njohurisëResponseType jashtë kërkesës.

Kërkesat për Kodet e Diagnostikimit (Problemit)

Për një kod problemi, MedlinePlus Connect do të kthejë lidhje dhe informacione nga faqet e temave shëndetësore MedlinePlus, faqet e gjenetikës ose faqet nga Institutet e tjera të NIH.

MedlinePlus Connect do të kthejë sa vijon:

Nuk mund të ketë gjithmonë një përputhje për secilin kod. Në ato raste, MedlinePlus Connect do të kthejë një përgjigje të pavlefshme.

URL-ja bazë e shërbimit është: https://connect.medlineplus.gov/service

Ka dy parametra të kërkuar për çdo pyetje për këtë shërbim:

1. Sistemi i kodit
   Identifikoni sistemin e kodit të problemit që do të përdorni.

   Për përdorim ICD-10-CM:

   Kriteret kryesore të Kërkimit.v.cs = 2.16.840.1.113883.6.90

   Për përdorim ICD-9-CM:

   Kriteret kryesore të kërkimit.v.cs = 2.16.840.1.113883.6.103

   Për SNOMED CT përdorni:

   Kriteret kryesore të Kërkimit.v.cs = 2.16.840.1.113883.6.96

2. Kodin
   Identifikoni kodin aktual që po përpiqeni të kërkoni:
   Kriteret kryesore të kërkimit.v.c = 250,33

Parametrat opsionalë

Titulli i kodit
Ju gjithashtu mund të identifikoni emrin / titullin e kodit të problemit. Sidoqoftë, ky informacion nuk ndikon në përgjigjen (ndryshe nga aplikacioni MedlinePlus Connect Web ku mund të përdoret informacioni për emrin / titullin). mainSearchCriteria.v.dn = Diabeti mellitus me koma tjetër tip 1 i pakontrolluar Shikoni seksionin e mësipërm në Parametrat e Daljes për detaje mbi formatet e gjuhës dhe daljes.

Përshkrimi i Elementeve të Zgjedhura të Atomit (ose objekteve JSON) në përgjigje të kërkesave të kodit të problemit

Element	Nyja e klasës	Përshkrim
titulli		Titulli i faqes së përputhur të temës shëndetësore MedlinePlus ose faqes GHR
lidhja		URL për faqen e përputhur të temës shëndetësore MedlinePlus ose faqen GHR
përmbledhje		Përmbledhja e plotë për temën shëndetësore. Kjo përfshin lidhje të ngulitura në tema të tjera të rëndësishme shëndetësore, dhe të gjithë formatimin, përfshirë plumbat dhe hapësirën e paragrafëve. Përmbledhja është në HTML. Për faqet GHR, sigurohet seksioni i parë i faqes së plotë.
përmbledhje		Sinonime për temën. Këto referohen si "Të quajtura gjithashtu" në një faqe të temës shëndetësore. Jo të gjitha temat kanë terma "Quhen gjithashtu".
përmbledhje		Mirënjohja e atributit për tekstin përmbledhës, nëse shumica e përmbledhjes ishte nga një agjenci tjetër federale. Jo të gjitha përmbledhjet kanë një atribut. Teksti i patribuar është origjinal për MedlinePlus.
përmbledhje		Lidhjet e zgjedhura që lidhen me temën. Kjo përfshin emrin e faqes, URL-në dhe organizatën e lidhur (kur është e zbatueshme). Lidhjet janë formatuar në një listë me pika. Jo të gjitha temat kanë këto lidhje. Numri i lidhjeve mund të shkojë nga zero në dhjetra.

Shembuj të kërkesave për kodet e problemit

Një kërkesë e plotë për Diabetes Mellitus me koma të tjera të tipit 1 të pakontrolluar, kodi ICD-9 250.33, për një pacient spanjishtfolës do të kishte adresën vijuese URL: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103 & mainSearchCriteria.vc = 250.33 & mainSearchCriteria.v.dn = Diabeti% 20mellitus% 20me% 20%% 20coma% lloji% 201% 20ontontrolluar & informacionRecipient.languageCode.c = es

Një pacient me të njëjtën diagnozë, por formati i kërkuar është JSON dhe gjuha është anglishtja: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33& KnowledgeResponseType=application / json

Një pacient i diagnostikuar me "Pneumoni për shkak të Pseudomonas" duke përdorur kodin CT SNOMED 41381004: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=4138100d&main Pneumonia% 20due% 20to% 20Pseudomonas% 20% 28çrregullimi% 29 & informationRecipient.languageCode.c = en

Një pacient me të njëjtën diagnozë, por formati i kërkuar është JSONP: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004& KnowledgeResponseType=applicationFault/javin

Shërbimet dhe skedarët e lidhur

Për të marrë tema shëndetësore MedlinePlus në përgjigje të kërkesave për tekst, në krahasim me kodet e problemit, hetoni shërbimin MedlinePlus Web. Gjithashtu, nëse keni nevojë për grupin e plotë të temave shëndetësore MedlinePlus në formatin XML, shihni faqen tonë të skedarëve XML.

Kërkesat për informacionin mbi ilaçet

MedlinePlus Connect ofron ndeshjet më të mira të informacionit për ilaçet kur merrni një RXCUI. Gjithashtu siguron rezultate të mira kur merrni një kod NDC. MedlinePlus Connect mund të sigurojë përgjigje në anglisht ose spanjisht.

Për kërkesat për informacion në lidhje me ilaçet në anglisht, nëse nuk dërgoni një NDC ose RXCUI ose nëse nuk gjejmë asnjë përputhje sipas kodit, aplikacioni do të përdorë vargun e tekstit që ju dërgoni për të shfaqur ndeshjen më të mirë të informacionit për ilaçet. Për kërkesat për informacione mjekësore spanjolle, MedlinePlus Connect u përgjigjet vetëm NDC ose RXCUI dhe nuk përdor vargje teksti. Possibleshtë e mundur të keni një përgjigje në anglisht, por asnjë përgjigje në spanjisht.

Shërbimi MedlinePlus Connect Web do të kthejë sa vijon:

Mund të ketë përgjigje të shumëfishta për një kërkesë për ilaçe. Jo gjithmonë mund të ketë një ndeshje për secilën kërkesë. Në ato raste, MedlinePlus Connect do të kthejë një përgjigje të pavlefshme.

Për kërkesat për informacion mbi ilaçet, URL-ja bazë është: https://connect.medlineplus.gov/service

Për të dërguar një kërkesë, përfshini këto informacione:

1. Sistemi i kodit
   Identifikoni llojin e kodit të ilaçeve që po dërgoni. (Kërkohet për anglisht dhe spanjisht)
   

   Për përdorim RXCUI:

   Kriteret kryesore të kërkimit.v.cs = 2.16.840.1.113883.6.88

   Për përdorim NDC:

   Kriteret kryesore të kërkimit.v.cs = 2.16.840.1.113883.6.69

   MedlinePlus Connect gjithashtu mund të pranojë një varg teksti për kërkesa për informacionin e ilaçeve në anglisht, por duhet të tregoni se po kërkoni informacionin e ilaçeve duke përfshirë një nga dy sistemet e kodit të renditura më sipër.
2. Kodin
   Identifikoni kodin aktual që po përpiqeni të kërkoni. (Preferohet për anglisht, kërkohet për spanjisht)
   Kriteret kryesore të kërkimit.v.c = 637188
3. Emri i barnave
   Identifikoni emrin e ilaçit me një varg teksti. (Opsionale për anglisht, nuk përdoret për spanjisht)
   mainSearchCriteria.v.dn = Tabletë me gojë Chantix 0,5 MG

Minimalisht duhet të identifikoni sistemin e kodit dhe kodin, ose sistemin e kodit dhe emrin e ilaçit. Dërgoni të tre për rezultatet më të mira për kërkesat angleze. Dërgoni sistemin e kodit dhe kodin për kërkesat spanjolle.

Parametrat opsionalë

Titulli i kodit

Kur dërgoni një kërkesë për informacion në anglisht, mund të përfshini parametrin opsional të emrit të ilaçit. Kjo është e detajuar në seksionin e mësipërm. mainSearchCriteria.v.dn = Tabletë me gojë Chantix 0,5 MG

Shihni seksionin e mësipërm në Parametrat e Daljes për detaje mbi formatet e gjuhës dhe daljes.

Përshkrimi i Elementeve të Zgjedhura të Atomit (ose objekteve JSON) në përgjigje të kërkesave të ilaçeve

Element	Përshkrim
titulli	Titulli për faqen e përputhur të ilaçeve MedlinePlus
lidhja	URL për faqen e përputhur të ilaçeve MedlinePlus
autor	Atribuimi i burimit për informacionin e ilaçeve

Shembuj të kërkesave për kodet e ilaçeve

Kërkesa juaj për informacionin e ilaçeve duhet të duket si një nga më poshtë.

Për të kërkuar informacion nga një RXCUI, kërkesa juaj duhet të duket kështu: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.88&mainSearchCriteria.vc=637188&mainSearchCriteria.ti.dn= 200.5% 20MG% 20Oral% 20Tabela dhe informacioniRecipient.languageCode.c = en

Për të kërkuar informacion nga një NDC për një spanjisht folës, kërkesa juaj duhet të duket si kjo: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-0751- 39 & informationRecipient.languageCode.c = es

Për të dërguar një varg teksti pa një kod të ilaçeve, duhet të identifikoni pyetjen tuaj si një kërkesë e tipit NDC në mënyrë që MedlinePlus Connect të dijë që jeni duke kërkuar informacione për ilaçet. Kjo do të funksionojë vetëm për kërkesat angleze. Kërkesa juaj mund të duket si kjo: 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.lang = en

Kërkesat për Informacionin e Testit të Laboratorit

MedlinePlus Connect ofron ndeshje me informacionin e provës laboratorike kur merrni një kërkesë LOINC. Shërbimi mund të ofrojë një përgjigje në anglisht ose spanjisht.

Shërbimi MedlinePlus Connect Web do të kthejë sa vijon:

Nuk mund të ketë gjithmonë një përputhje për secilin kod. Në ato raste, MedlinePlus Connect do të kthejë një përgjigje të pavlefshme.

URL-ja bazë e shërbimit është: https://connect.medlineplus.gov/service

Këto janë dy parametra të kërkuar për çdo pyetje të testit laboratorik për këtë shërbim:

1. Sistemi i kodit
   

   Identifikoni që jeni duke përdorur sistemin e kodit LOINC. Përdorni:

   Kriteret kryesore të kërkimit.v.cs = 2.16.840.1.113883.6.1

   MedlinePlus Connect gjithashtu do të pranojë:

   Kriteret kryesore të kërkimit.v.cs = 2.16.840.1.113883.11.79

2. Kodin
   identifikoni kodin aktual që po përpiqeni të kërkoni:
   Kriteret kryesore të kërkimit.v.c = 3187-2

Parametrat opsionalë

Titulli i kodit

Ju gjithashtu mund të identifikoni emrin e testit laboratorik. Sidoqoftë, ky informacion nuk ndikon në përgjigjen. mainSearchCriteria.v.dn = Analiza e Faktorit IX

Shihni seksionin e mësipërm në Parametrat e Daljes për detaje mbi formatet e gjuhës dhe daljes.

Përshkrimi i Elementeve të Zgjedhura të Atomit (ose objekteve JSON) në përgjigje të kërkesave të Testit të Laboratorit

Element	Përshkrim
titulli	Titulli i faqes së provës laboratorike të MedlinePlus
lidhja	URL për faqen e provës së laboratorit MedlinePlus
përmbledhje	Fragment nga përmbajtja e faqes
autor	Atribuimi i burimit për përmbajtjen e testit laboratorik

Shembuj të kërkesave për testet laboratorike

Për të kërkuar informacion për një folës të anglishtes, kërkesa juaj mund të duket si një nga sa më poshtë: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = Faktori% 20IX% 20sprovë & informationRecipient.languageCode.c = sq https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&langji = en

Për të kërkuar informacion për një spanjisht folës, kërkesa juaj mund të duket si një nga më poshtë: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = Faktori% 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&langji = es

Politika e pranueshme e përdorimit

Në mënyrë që të shmanget mbingarkesa e serverave MedlinePlus, NLM kërkon që përdoruesit e MedlinePlus Connect të dërgojnë jo më shumë se 100 kërkesa në minutë për adresën IP. Kërkesat që tejkalojnë këtë kufi nuk do të servisohen dhe shërbimi nuk do të rikthehet për 300 sekonda ose derisa niveli i kërkesës të bjerë nën kufirin, cilado që të vijë më vonë. Për të kufizuar numrin e kërkesave që ju dërgoni te Connect, NLM rekomandon rezultatet e caching për një periudhë 12-24 orë.

Kjo politikë ekziston për të siguruar që shërbimi të mbetet i disponueshëm dhe i arritshëm për të gjithë përdoruesit. Nëse keni një rast specifik përdorimi që kërkon që të dërgoni një numër të madh të kërkesave në MedlinePlus Connect, dhe kështu të tejkaloni kufirin e normës së kërkesës të përshkruar në këtë politikë, ju lutemi na kontaktoni. Stafi i NLM do të vlerësojë kërkesën tuaj dhe do të përcaktojë nëse një përjashtim mund të jepet. Ju lutemi rishikoni dokumentacionin e skedarëve MedlinePlus XML. Këto skedarë XML përmbajnë të dhëna të plota të temave shëndetësore dhe mund të shërbejnë si një metodë alternative e hyrjes në të dhënat e MedlinePlus.

Më shumë informata