Forfatter: Eric Farmer
Oprettelsesdato: 4 Marts 2021
Opdateringsdato: 21 November 2024
Anonim
MedlinePlus Connect: Webtjeneste - Medicin
MedlinePlus Connect: Webtjeneste - Medicin

Indhold

MedlinePlus Connect fås som en webapplikation eller en webtjeneste. Nedenfor er de tekniske detaljer til implementering af webservicen, som svarer på anmodninger baseret på:

Du er velkommen til at linke til og vise de data, der returneres af MedlinePlus Connect. Du kan ikke kopiere MedlinePlus-sider til dit websted. Hvis du bruger data fra MedlinePlus Connect-webservicen, skal du angive, at oplysningerne kommer fra MedlinePlus.gov, men ikke bruge MedlinePlus-logoet eller på anden måde antyde, at MedlinePlus godkender dit særlige produkt. Se NLMs API-side for yderligere vejledning. For mere information om, hvordan du linker til MedlinePlus-indhold uden for denne service, se venligst vores retningslinjer og instruktioner om sammenkædning.

Hvis du beslutter dig for at bruge MedlinePlus Connect, kan du tilmelde dig e-mail-listen for at holde trit med udviklingen og udveksle ideer med dine kolleger. Fortæl os, hvis du implementerer MedlinePlus Connect ved at kontakte os.

Webtjenesteoversigt

Parametrene til webserviceanmodningerne er i overensstemmelse med HL7 Context-Aware Knowledge Retrieval (Infobutton) Knowledge Request URL-Based Implementation Guide. Det REST-baserede svar er i overensstemmelse med HL7 Context-Aware Knowledge Retrieval (Infobutton) Service-Oriented Architecture Implementation Guide. Outputtet fra anmodningen kan være XML i Atom-feedformat, JSON eller JSONP.


Anmodningens struktur angiver, hvilken type kode du sender. I alle tilfælde er basis-URL'en til webtjenesten: https://connect.medlineplus.gov/service

MedlinePlus Connect bruger HTTPS-forbindelser. HTTP-anmodninger accepteres ikke, og eksisterende implementeringer, der bruger HTTP, skal opdateres til HTTPS.

Outputparametre

Disse parametre er valgfri. Hvis du udelader dem, er standardsvaret engelske oplysninger i XML-format.

Sprog
Identificer, om du vil have svaret på engelsk eller spansk. MedlinePlus Connect antager, at engelsk er sproget, hvis det ikke er specificeret.

Hvis du ønsker, at svaret på problemkodeopslaget skal være på spansk, skal du bruge: informationRecipient.languageCode.c = es
(= sp accepteres også)

For at specificere engelsk skal du bruge følgende: informationRecipient.languageCode.c = da

Format
Identificer, om svarformatet skal være XML, JSON eller JSONP. XML er standard.

For at anmode om JSON skal du bruge:
knowledgeResponseType = applikation / json
Til JSONP skal du bruge:
knowledgeResponseType = application / javascript & callback = CallbackFunction hvor CallbackFunction er et navn, du giver tilbagekaldsfunktionen.
Brug et af svarene i XML:
knowledgeResponseType = text / xml eller lad parameteren scienceResponseType være ude af anmodningen.


Anmodninger om diagnose (problem) koder

For en problemkode vil MedlinePlus Connect returnere links og information fra MedlinePlus sundhedsemnesider, genetikssider eller sider fra andre NIH-institutter.

MedlinePlus Connect returnerer følgende:

Der er muligvis ikke altid et match for hver kode. I disse tilfælde returnerer MedlinePlus Connect et null-svar.

Tjenestens grundlæggende URL er: https://connect.medlineplus.gov/service

Der er to påkrævede parametre for enhver forespørgsel til denne tjeneste:

  1. Kodesystem
    Identificer det problemkodesystem, du bruger.
    Til ICD-10-CM brug:
    mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90
    Til ICD-9-CM brug:
    mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103
    Til brug af SNOMED CT:
    mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96
  2. Kode
    Identificer den aktuelle kode, som du prøver at slå op:
    mainSearchCriteria.v.c = 250.33


Valgfri parametre

Kodetitel
Du kan også identificere navnet / titlen på problemkoden. Disse oplysninger påvirker dog ikke svaret (i modsætning til MedlinePlus Connect-webapplikationen, hvor oplysningerne om navn / titel kan bruges). mainSearchCriteria.v.dn = Diabetes mellitus med anden koma type 1 ukontrolleret Se ovenstående afsnit om outputparametre for detaljer om sprog og outputformater.

Beskrivelse af valgte atomelementer (eller JSON-objekter) som reaktion på anmodninger om problemkoder

ElementKlasseknudeBeskrivelse
titel Titel på den matchede MedlinePlus-sundhedsemneside eller GHR-side
link URL til matchet MedlinePlus-sundhedsemneside eller GHR-side
Resumé Det komplette resumé for sundhedsemnet. Dette inkluderer indlejrede links til andre relevante sundhedsemner og al formatering, herunder punkttegn og afsnitafstand. Resuméet er i HTML. For GHR-sider findes den første sektion af hele siden.
ResuméSynonymer til emnet. Disse kaldes "Også kaldet" på en side om sundhedsemne. Ikke alle emner har "Også kaldet" termer.
ResuméAttribution-kvittering for resumétekst, hvis størstedelen af ​​resuméet var fra et andet føderalt agentur. Ikke alle resuméer har en tilskrivning. Utilskrevet tekst er original til MedlinePlus.
ResuméUdvalgte links, der er knyttet til emnet. Dette inkluderer sidens navn, URL og tilknyttet organisation (hvis relevant). Links er formateret i en punktopstilling. Ikke alle emner har disse links. Antallet af links kan variere fra nul til dusinvis.

Eksempler på anmodninger om problemkoder

En komplet anmodning om diabetes mellitus med anden koma type 1 ukontrolleret, ICD-9 kode 250.33, for en spansktalende patient ville have følgende URL-adresse: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103 & mainSearchCriteria.vc = 250.33 & mainSearchCriteria.v.dn = Diabetes% 20mellitus% 20med% 20other% 20coma% 20type% 201% 20 ukontrolleret & informationRecipient.languageCode.c = es

En patient med samme diagnose, men det ønskede format er JSON, og sproget er engelsk: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application / json

En patient diagnosticeret med "lungebetændelse på grund af Pseudomonas" ved hjælp af 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= Lungebetændelse% 20due% 20to% 20Pseudomonas% 20% 28disorder% 29 & informationRecipient.languageCode.c = da

En patient med samme diagnose, men det ønskede format, er 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

Relaterede tjenester og filer

Hvis du vil modtage MedlinePlus-sundhedsemner som svar på tekstanmodninger, i modsætning til problemkoder, skal du undersøge MedlinePlus-webservicen. Hvis du har brug for det fulde sæt af MedlinePlus-sundhedsemner i XML-format, skal du også se vores XML-filside.

Anmodninger om lægemiddelinformation

MedlinePlus Connect giver de bedste matchningsoplysninger om medicin, når de modtager en RXCUI. Det giver også gode resultater, når du modtager en NDC-kode. MedlinePlus Connect kan levere svar på engelsk eller spansk.

For anmodninger om engelsk medicininformation, hvis du ikke sender en NDC eller RXCUI, eller hvis vi ikke finder noget match baseret på koden, bruger applikationen den tekststreng, du sender til at vise det bedste match med lægemiddelinformation. For anmodninger om spansk medicininformation, reagerer MedlinePlus Connect kun på NDC'er eller RXCUI'er og bruger ikke tekststrenge. Det er muligt at have et svar på engelsk, men intet svar på spansk.

MedlinePlus Connect-webservicen returnerer følgende:

Der kan være flere svar på en anmodning om medicin. Der er muligvis ikke altid et match for hver anmodning. I disse tilfælde returnerer MedlinePlus Connect et null-svar.

For anmodninger om lægemiddeloplysninger er base-URL: https://connect.medlineplus.gov/service

For at sende en anmodning skal du inkludere disse oplysninger:

  1. Kodesystem
    Identificer den type medicinkode, du sender. (Påkrævet for engelsk og spansk)
    Til RXCUI-brug:
    mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88
    Til NDC-brug:
    mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69
    MedlinePlus Connect kan også acceptere en tekststreng til anmodninger om medicinoplysninger på engelsk, men du skal angive, at du leder efter medicinoplysninger ved at inkludere et af de to kodesystemer, der er anført ovenfor.
  2. Kode
    Identificer den faktiske kode, som du prøver at slå op. (Foretrækkes for engelsk, kræves for spansk)
    mainSearchCriteria.v.c = 637188
  3. Lægemiddelnavn
    Identificer navnet på lægemidlet med en tekststreng. (Valgfri til engelsk, bruges ikke til spansk)
    mainSearchCriteria.v.dn = Chantix 0,5 mg oral tablet
Som et minimum skal du identificere kodesystemet og koden eller kodesystemet og stoffets navn. Send alle tre for at få de bedste resultater for engelske anmodninger. Send kodesystemet og koden til spanske anmodninger.

Valgfri parametre

Kodetitel

Når du sender en anmodning om engelsk information, kan du medtage den valgfri parameter for medicinens navn. Dette er beskrevet i ovenstående afsnit. mainSearchCriteria.v.dn = Chantix 0,5 mg oral tablet

Se ovenstående afsnit om outputparametre for detaljer om sprog og outputformater.

Beskrivelse af valgte atomelementer (eller JSON-objekter) som svar på medicinanmodninger

ElementBeskrivelse
titelTitel til matchet MedlinePlus medicin-side
linkURL til den matchede MedlinePlus medicin-side
forfatterKildetildeling for medicinoplysninger

Eksempler på anmodninger om lægemiddelkoder

Din anmodning om medicinoplysninger skal se ud som en af ​​følgende.

For at anmode om oplysninger fra en RXCUI skal din anmodning se sådan ud: 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 = da

For at anmode om oplysninger fra en NDC for en spansk højttaler, skal din anmodning se sådan ud: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-0751- 39 & informationRecipient.languageCode.c = es

For at sende en tekststreng uden en medicineringskode skal du identificere din forespørgsel som en NDC-type anmodning, så MedlinePlus Connect ved, at du leder efter medicinoplysninger. Dette fungerer kun for engelske anmodninger. Din anmodning kan se sådan ud: 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 = da

Anmodninger om laboratorietestinformation

MedlinePlus Connect giver matches med laboratorietestoplysninger, når de modtager en LOINC-anmodning. Tjenesten kan give et svar på engelsk eller spansk.

MedlinePlus Connect-webservicen returnerer følgende:

Der er muligvis ikke altid et match for hver kode. I disse tilfælde returnerer MedlinePlus Connect et null-svar.

Tjenestens grundlæggende URL er: https://connect.medlineplus.gov/service

Dette er to krævede parametre for enhver laboratorietestforespørgsel til denne service:

  1. Kodesystem
    Identificer, at du bruger LOINC-kodesystemet. Brug:
    mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1
    MedlinePlus Connect accepterer også:
    mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79
  2. Kode
    identificer den aktuelle kode, du prøver at slå op:
    mainSearchCriteria.v.c = 3187-2

Valgfri parametre

Kodetitel

Du kan også identificere navnet på laboratorietesten. Disse oplysninger påvirker imidlertid ikke svaret. mainSearchCriteria.v.dn = Faktor IX-analyse

Se ovenstående afsnit om outputparametre for detaljer om sprog og outputformater.

Beskrivelse af valgte atomelementer (eller JSON-objekter) som svar på laboratorietestanmodninger

ElementBeskrivelse
titelTitel på matchet MedlinePlus-testside
linkURL til matchet MedlinePlus-testside
ResuméStykke fra sideindholdet
forfatterKildetildeling for laboratorietestens indhold

Eksempler på anmodninger om laboratorietests

For at anmode om oplysninger til en engelsktalende kan din anmodning se ud som en af ​​følgende: 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 = da https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.languageCode.c = da

For at anmode om oplysninger til en spansk højttaler kan din anmodning se ud som en af ​​følgende: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn = Faktor% 20IX% 20 analyse & 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

Politik for acceptabel brug

For at undgå overbelastning af MedlinePlus-serverne kræver NLM, at brugere af MedlinePlus Connect ikke sender mere end 100 anmodninger pr. Minut pr. IP-adresse. Anmodninger, der overstiger denne grænse, vil ikke blive serviceret, og servicen gendannes ikke i 300 sekunder, eller indtil anmodningshastigheden falder under grænsen, alt efter hvad der kommer senere. For at begrænse antallet af anmodninger, du sender til Connect, anbefaler NLM cache-resultater i en periode på 12-24 timer.

Denne politik er på plads for at sikre, at tjenesten forbliver tilgængelig og tilgængelig for alle brugere. Hvis du har en specifik brugssag, der kræver, at du sender et stort antal anmodninger til MedlinePlus Connect og dermed overskrider den anmodningshastighedsgrænse, der er beskrevet i denne politik, bedes du kontakte os. NLM-personale vil evaluere din anmodning og afgøre, om der kan gives en undtagelse. Gennemse også dokumentationen til MedlinePlus XML-filer. Disse XML-filer indeholder komplette sundhedsemneoptegnelser og kan fungere som en alternativ metode til at få adgang til MedlinePlus-data.

Mere information

Interessante Artikler

Hvad er lavklasse squamøs intraepithelial læsion (LSIL)?
Sundhed

Hvad er lavklasse squamøs intraepithelial læsion (LSIL)?

Lavklae quamou intraepithelial læion (LIL) er et almindeligt unormalt reultat på en Pap-tet. Det er ogå kendt om mild dyplai. LIL betyder, at dine cervikale celler vier milde abnormitet...
Fenofibrat, oral tablet
Sundhed

Fenofibrat, oral tablet

Fenofibrat oral tablet få om mærkenavne og om generik medicin. Mærkenavne: Fenoglide, Tricor og Triglide.Fenofibrat finde i to former: oral tablet og oral kapel.Fenofibrat oral tablet b...