MedlinePlus Connect: webdiens

Tevrede

• Webdiensoorsig
• Uitsetparameters
• Versoeke vir diagnosekodes
• Opsionele parameters
• Beskrywing van geselekteerde atoomelemente (of JSON-voorwerpe) in reaksie op probleemkodeversoeke
• Voorbeelde van versoeke vir probleemkodes
• Verwante dienste en lêers
• Versoeke om dwelminligting
• Opsionele parameters
• Beskrywing van geselekteerde atoomelemente (of JSON-voorwerpe) in antwoord op medisyneversoeke
• Voorbeelde van versoeke vir dwelmkodes
• Versoeke vir laboratoriumtoetsinligting
• Opsionele parameters
• Beskrywing van geselekteerde atoomelemente (of JSON-voorwerpe) in reaksie op laboratoriumtoetsversoeke
• Voorbeelde van versoeke vir laboratoriumtoetse
• Aanvaarbare gebruiksbeleid
• Meer inligting

MedlinePlus Connect is beskikbaar as 'n webtoepassing of webdiens. Hieronder is die tegniese besonderhede vir die implementering van die webdiens, wat reageer op versoeke gebaseer op:

U is welkom om die data wat deur MedlinePlus Connect teruggestuur word, te skakel en weer te gee. U mag nie MedlinePlus-bladsye na u webwerf kopieer nie. As u data van die MedlinePlus Connect-webdiens gebruik, moet u asseblief aandui dat die inligting van MedlinePlus.gov afkomstig is, maar nie die MedlinePlus-logo gebruik nie, of andersins impliseer dat MedlinePlus u spesifieke produk onderskryf. Raadpleeg die API-bladsy van NLM vir verdere leiding. Vir meer inligting oor hoe om na MedlinePlus-inhoud buite hierdie diens te skakel, sien ons riglyne en instruksies oor die skakel.

As u besluit om MedlinePlus Connect te gebruik, meld u aan vir die e-poslys om tred te hou met die ontwikkeling en idees met u kollegas uit te ruil. Vertel ons as u MedlinePlus Connect implementeer deur ons te kontak.

Webdiensoorsig

Die parameters vir die webdiensversoeke voldoen aan die HL7 Context-Aware Knowledge Retrieval (Infobutton) Knowledge Request URL-Based Implementation Guide. Die REST-gebaseerde reaksie is in ooreenstemming met die HL7 Context-Aware Knowledge Retrieval (Infobutton) Service-Oriented Architecture Implementation Guide. Die uitvoer van die versoek kan XML in die Atom-voerformaat, JSON, of JSONP wees.

Die struktuur van die versoek dui aan watter tipe kode u stuur. In alle gevalle is die basis-URL vir die webdiens: https://connect.medlineplus.gov/service

MedlinePlus Connect gebruik HTTPS-verbindings. HTTP-versoeke sal nie aanvaar word nie en bestaande implementasies wat HTTP gebruik, moet na HTTPS opgedateer word.

Uitsetparameters

Hierdie parameters is opsioneel. As u dit uitlaat, is die Engelse inligting in XML-formaat die verstekreaksie.

Taal
Identifiseer of u die antwoord in Engels of Spaans wil hê. MedlinePlus Connect aanvaar dat Engels die taal is as dit nie gespesifiseer word nie.

Gebruik die volgende: informationRecipient.languageCode.c = es as u wil reageer op die probleemkode in Spaans.
(= sp ook aanvaar)

Om Engels te spesifiseer, gebruik die volgende: informationRecipient.languageCode.c = af

Formaat
Identifiseer of u die antwoordformaat XML, JSON of JSONP wil hê. XML is die standaard.

Om JSON aan te vra, gebruik:

knowledgeResponseType = toepassing / json

Gebruik vir JSONP:

knowledgeResponseType = application / javascript & callback = CallbackFunction waar CallbackFunction 'n naam is wat u die terugbelfunksie gee.

Gebruik 'n antwoord in XML:

knowledgeResponseType = text / xml of laat die parameter knowledgeResponseType buite die versoek.

Versoeke vir diagnosekodes

Vir 'n probleemkode sal MedlinePlus Connect skakels en inligting terugstuur vanaf MedlinePlus-gesondheidsonderwerpbladsye, genetika-bladsye of bladsye van ander NIH-institute.

MedlinePlus Connect sal die volgende terugstuur:

Daar is miskien nie altyd 'n pasmaat vir elke kode nie. In daardie gevalle sal MedlinePlus Connect 'n nul-antwoord lewer.

Die basis-URL van die diens is: https://connect.medlineplus.gov/service

Daar is twee vereiste parameters vir enige navrae aan hierdie diens:

1. Kodestelsel
   Identifiseer die probleemkodesisteem wat u gaan gebruik.

   Vir die gebruik van ICD-10-CM:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90

   Vir die gebruik van ICD-9-CM:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103

   Vir SNOMED CT gebruik:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96

2. Kode
   Identifiseer die werklike kode wat u probeer opsoek:
   mainSearchCriteria.v.c = 250.33

Opsionele parameters

Kode titel
U kan ook die naam / titel van die probleemkode identifiseer. Hierdie inligting beïnvloed egter nie die reaksie nie (anders as die MedlinePlus Connect-webtoepassing waar die naam- / titelinligting gebruik kan word). mainSearchCriteria.v.dn = Diabetes mellitus met ander koma tipe 1 ongekontroleerd Sien die bostaande afdeling oor die uitvoerparameters vir besonderhede oor taal- en uitvoerformate.

Beskrywing van geselekteerde atoomelemente (of JSON-voorwerpe) in reaksie op probleemkodeversoeke

Element	Klasknoop	Beskrywing
titel		Titel van ooreenstemmende MedlinePlus-gesondheidsonderwerpbladsy of GHR-bladsy
skakel		URL vir ooreenstemmende MedlinePlus-gesondheidsonderwerpbladsy of GHR-bladsy
opsomming		Die volledige opsomming vir die gesondheidsonderwerp. Dit sluit in ingeboude skakels na ander relevante gesondheidsonderwerpe, en alle opmaak, insluitend kolpunte en paragraafafstand. Die opsomming is in HTML. Vir GHR-bladsye word die eerste gedeelte van die volledige bladsy verskaf.
opsomming		Sinonieme vir die onderwerp. Dit word op 'n gesondheidsonderwerpbladsy na verwys as 'Ook genoem'. Nie alle onderwerpe het terme "Ook genoem" nie.
opsomming		Erkenning van erkenning vir opsommende teks, as die meerderheid van die opsomming van 'n ander federale agentskap was. Nie alle opsommings het 'n toeskrywing nie. Ongeskrewe teks is oorspronklik van MedlinePlus.
opsomming		Geselekteerde skakels wat verband hou met die onderwerp. Dit sluit die bladsynaam, URL en gepaardgaande organisasie (indien van toepassing) in. Die skakels word in 'n kolpuntlys geformateer. Nie alle onderwerpe het hierdie skakels nie. Die aantal skakels kan wissel van nul tot dosyne.

Voorbeelde van versoeke vir probleemkodes

'N Volledige versoek vir Diabetes Mellitus met 'n ander coma tipe 1, ICD-9-kode 250.33, vir 'n Spaanssprekende pasiënt het die volgende URL-adres: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103 & mainSearchCriteria.vc = 250.33 & mainSearchCriteria.v.dn = Diabetes% 20mellitus% 20met% 20other% 20coma% 20type% 201% 20onbeheerde & informationRecipient.languageCode.c = es

'N Pasiënt met dieselfde diagnose, maar die aangevraagde formaat, is JSON en die taal is Engels: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application / json

'N Pasiënt wat gediagnoseer is met' Longontsteking as gevolg van Pseudomonas 'met behulp van SNOMED CT-kode 41381004: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v.dn= Longontsteking% 20due% 20to% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.languageCode.c = af

'N Pasiënt met dieselfde diagnose, maar die gevraagde formaat, is JSONP: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javascript&callback=CallbackFallback

Verwante dienste en lêers

Om MedlinePlus-gesondheidsonderwerpe te ontvang in reaksie op teksversoeke, in teenstelling met probleemkodes, moet u die MedlinePlus-webdiens ondersoek. As u ook die volledige reeks MedlinePlus-gesondheidsonderwerpe in XML-formaat benodig, raadpleeg ons XML-lêersbladsy.

Versoeke om dwelminligting

MedlinePlus Connect bied die beste medisyne-inligting wat ooreenstem met die ontvangs van 'n RXCUI. Dit lewer ook goeie resultate as u 'n NDC-kode ontvang. MedlinePlus Connect kan antwoorde in Engels of Spaans lewer.

As u nie 'n NDC of RXCUI stuur nie, of as ons geen ooreenstemming op grond van die kode vind nie, sal die aansoek die teksstring wat u stuur, gebruik om die beste inligting vir dwelminligting te toon, indien u nie 'n NDC of RXCUI stuur nie. Vir versoeke vir Spaanse medisyne-inligting reageer MedlinePlus Connect slegs op NDC's of RXCUI's en gebruik dit nie teksstringe nie. Dit is moontlik om 'n antwoord in Engels te hê, maar geen antwoord in Spaans nie.

Die MedlinePlus Connect-webdiens lewer die volgende op:

Daar kan verskeie reaksies op een medisyneversoek wees. Daar is miskien nie altyd 'n wedstryd vir elke versoek nie. In daardie gevalle sal MedlinePlus Connect 'n nul-antwoord lewer.

Die basis-URL vir versoeke vir dwelminligting is: https://connect.medlineplus.gov/service

Sluit die volgende inligting in om 'n versoek te stuur:

1. Kodestelsel
   Identifiseer die tipe medikasiekode wat u stuur. (Vereis vir Engels en Spaans)
   

   Vir RXCUI gebruik:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88

   Vir NDC gebruik:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69

   MedlinePlus Connect kan ook 'n teksreeks aanvaar vir versoeke om inligting oor medisyne in Engels, maar u moet aandui dat u medisyne-inligting soek deur een van die twee kodesisteme hierbo in te sluit.
2. Kode
   Identifiseer die werklike kode wat u probeer naslaan. (Voorkeur vir Engels, vereis vir Spaans)
   mainSearchCriteria.v.c = 637188
3. Dwelmsnaam
   Identifiseer die naam van die middel met 'n teksstring. (Opsioneel vir Engels, word nie vir Spaans gebruik nie)
   mainSearchCriteria.v.dn = Chantix 0,5 mg mondelinge tablet

U moet ten minste die kodestelsel, die kode of die kodestelsel en die naam van die geneesmiddel identifiseer. Stuur al drie vir die beste resultate vir Engelse versoeke. Stuur die kodestelsel en die kode vir Spaanse versoeke.

Opsionele parameters

Kode titel

As u 'n versoek vir Engelse inligting stuur, kan u die opsionele parameter van die naam van die medikasie insluit. Dit word in die bostaande gedeelte uiteengesit. mainSearchCriteria.v.dn = Chantix 0,5 mg mondelinge tablet

Sien die bostaande afdeling oor die uitvoerparameters vir inligting oor taal- en uitvoerformate.

Beskrywing van geselekteerde atoomelemente (of JSON-voorwerpe) in antwoord op medisyneversoeke

Element	Beskrywing
titel	Titel vir ooreenstemmende MedlinePlus-medisyne-bladsy
skakel	URL vir die ooreenstemmende MedlinePlus-medisyne-bladsy
skrywer	Bron-toeskrywing vir medisyne-inligting

Voorbeelde van versoeke vir dwelmkodes

U medisyne-inligtingsversoek moet soos een van die volgende lyk.

Om inligting deur 'n RXCUI aan te vra, moet u versoek so lyk: 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% 20 Orale% 20 Tabel en inligting Ontvanger.taalkode.c = af

Om inligting deur 'n NDC vir 'n Spaansspreker aan te vra, moet u versoek so lyk: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-0751- 39 & inligtingRecipient.languageCode.c = es

Om 'n teksstring sonder medikasiekode te stuur, moet u u navraag identifiseer as 'n NDC-tipe versoek, sodat MedlinePlus Connect weet dat u medisyne-inligting soek. Dit sal slegs vir Engelse versoeke werk. U versoek kan so lyk: 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 = af

Versoeke vir laboratoriumtoetsinligting

MedlinePlus Connect bied ooreenstemmings met laboratoriumtoetsinligting wanneer 'n LOINC-versoek ontvang word. Die diens kan in Engels of Spaans reageer.

Die MedlinePlus Connect-webdiens lewer die volgende op:

Daar is miskien nie altyd 'n pasmaat vir elke kode nie. In daardie gevalle sal MedlinePlus Connect 'n nul-antwoord lewer.

Die basis-URL van die diens is: https://connect.medlineplus.gov/service

Dit is twee vereiste parameters vir enige laboratoriumtoetsnavrae aan hierdie diens:

1. Kodestelsel
   

   Identifiseer dat u die LOINC-kodesisteem gebruik. Gebruik:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1

   MedlinePlus Connect aanvaar ook:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79

2. Kode
   identifiseer die werklike kode wat u probeer naslaan:
   mainSearchCriteria.v.c = 3187-2

Opsionele parameters

Kode titel

U kan ook die naam van die laboratoriumtoets identifiseer. Hierdie inligting beïnvloed egter nie die reaksie nie. mainSearchCriteria.v.dn = Faktor IX-toets

Sien die bostaande afdeling oor die uitvoerparameters vir inligting oor taal- en uitvoerformate.

Beskrywing van geselekteerde atoomelemente (of JSON-voorwerpe) in reaksie op laboratoriumtoetsversoeke

Element	Beskrywing
titel	Titel van ooreenstemmende MedlinePlus-laboratoriumtoetsbladsy
skakel	URL vir ooreenstemmende MedlinePlus-laboratoriumtoetsbladsy
opsomming	Stukkie uit die bladsyinhoud
skrywer	Bron toekenning vir die laboratorium toetsinhoud

Voorbeelde van versoeke vir laboratoriumtoetse

Om inligting vir 'n Engelssprekende aan te vra, kan u versoek soos een van die volgende lyk: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = Faktor% 20IX% 20assay & informationRecipient.languageCode.c = nl https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.languageCode.c = af

Om inligting vir 'n Spaansspreker aan te vra, kan u versoek soos een van die volgende lyk: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = Faktor% 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.languageCode.c = es

Aanvaarbare gebruiksbeleid

Om oorbelasting van die MedlinePlus-bedieners te voorkom, vereis NLM dat gebruikers van MedlinePlus Connect nie meer as 100 versoeke per minuut per IP-adres moet stuur nie. Versoeke wat hierdie limiet oorskry, sal nie gediens word nie en die diens sal nie vir 300 sekondes herstel word of totdat die versoektarief onder die limiet val nie, wat ook al later kom. Om die aantal versoeke wat u aan Connect stuur, te beperk, beveel NLM cache-resultate aan vir 'n periode van 12-24 uur.

Hierdie beleid is ingestel om te verseker dat die diens beskikbaar en toeganklik bly vir alle gebruikers. As u 'n spesifieke gebruiksgeval het wat vereis dat u 'n groot aantal versoeke na MedlinePlus Connect moet stuur en dus die limiet vir die versoektarief wat in hierdie beleid uiteengesit word, oorskry, kontak ons ​​asseblief. NLM-personeel sal u versoek evalueer en bepaal of 'n uitsondering toegestaan ​​kan word. Lees ook die MedlinePlus XML-lêersdokumentasie. Hierdie XML-lêers bevat volledige gesondheidsonderwerprekords en kan dien as alternatiewe toegang tot MedlinePlus-data.

Meer inligting