MedlinePlus Connect: webapplicatie

Inhoud

• Overzicht webapplicatie
• Verzoeken om diagnose (probleem) codes
• Optionele parameters:
• Voorbeelden van verzoeken om probleemcodes
• Verzoeken om informatie over geneesmiddelen
• Optionele parameters:
• Voorbeelden van verzoeken om medicijncodes
• Verzoeken om informatie over laboratoriumtests
• Optionele parameters:
• Voorbeelden van aanvragen voor laboratoriumtests
• Aanvaardbaar gebruik beleid
• Meer informatie

MedlinePlus Connect is beschikbaar als webapplicatie of webservice. Hieronder vindt u de technische details voor het implementeren van de webapplicatie, die reageert op verzoeken op basis van:

Als je besluit om MedlinePlus Connect te gebruiken, meld je dan aan voor de e-maillijst om op de hoogte te blijven van de ontwikkelingen en ideeën uit te wisselen met je collega's. Laat het ons weten als u MedlinePlus Connect implementeert door contact met ons op te nemen. U bent van harte welkom om te linken naar de gegevens die door MedlinePlus Connect worden verstrekt en deze weer te geven. Voor meer informatie over het linken naar MedlinePlus-inhoud buiten deze service, raadpleegt u onze richtlijnen en instructies voor het koppelen.

Overzicht webapplicatie

De API voor de webtoepassing voldoet aan de HL7 Context-Aware Knowledge Retrieval (Infobutton) Knowledge Request URL-Based Implementation-specificatie. De structuur van het verzoek geeft aan welk type code u verstuurt. In alle gevallen is de basis-URL voor de webtoepassing: https://connect.medlineplus.gov/application

MedlinePlus Connect maakt gebruik van HTTPS-verbindingen. HTTP-verzoeken worden niet geaccepteerd en bestaande implementaties die HTTP gebruiken, moeten worden bijgewerkt naar HTTPS.

Verzoeken om diagnose (probleem) codes

MedlinePlus Connect koppelt ICD-10-CM-, ICD-9-CM- of SNOMED CT-codes aan gerelateerde MedlinePlus-pagina's met gezondheidsthema's, geneticapagina's of pagina's van andere NIH-instituten. Een patiënt met de diagnose ICD-9-CM-code 493.12, Extrinsieke astma met exacerbatie, kan bijvoorbeeld een link in een elektronisch gezondheidsdossier (EPD) krijgen die leidt naar de MedlinePlus-pagina Astma.

Deze link geeft een pagina weer met een leeg zoekvak. Er zijn twee vereiste parameters voor elke query naar deze toepassing:

1. Identificeer het probleemcodesysteem dat u gaat gebruiken.
   

   Voor ICD-10-CM gebruik:

   mainSearchCriteria.v.cs=2.16.840.1.113883.6.90

   Voor ICD-9-CM gebruik:

   mainSearchCriteria.v.cs=2.16.840.1.113883.6.103

   Voor gebruik van SNOMED CT:

   mainSearchCriteria.v.cs=2.16.840.1.113883.6.96

2. Identificeer de daadwerkelijke code die u probeert op te zoeken:
   mainSearchCriteria.v.c=250.33

Optionele parameters:

Identificeer de naam/titel van de probleemcode. Het verzenden van geen code resulteert in een zoekopdracht naar de MedlinePlus-zoekmachine. Als u een code en de naam/titel van de code opgeeft, maar MedlinePlus Connect geen resultaten heeft, geeft de antwoordpagina een MedlinePlus-zoekvak weer dat vooraf is ingevuld met de naam/titel. mainSearchCriteria.v.dn=Diabetes mellitus met ander ongecontroleerd coma type 1

Geef aan of u het verzoek in het Engels of Spaans wilt hebben. MedlinePlus Connect gaat ervan uit dat Engels de taal is als dit niet is opgegeven.

Als u wilt dat het antwoord op het opzoeken van de probleemcode in het Spaans is, gebruikt u: informationRecipient.languageCode.c=es
(=sp ook geaccepteerd)

Gebruik het volgende om Engels op te geven: informationRecipient.languageCode.c=en

Voorbeelden van verzoeken om probleemcodes

Een volledig verzoek voor Diabetes Mellitus met ander ongecontroleerd coma type 1, ICD-9 code 250.33, voor een Spaanssprekende patiënt zou het volgende URL-adres hebben: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103&mainSearchCriteria.vc=250.33&mainSearchCriteria.v.dn=Diabetes%20mellitus%20with%20other%20coma%20type%201%20uncontroll&informationRecipient.languageCode.c=es

Een patiënt gediagnosticeerd met "Pneumonie als gevolg van Pseudomonas" met behulp van SNOMED CT-code 41381004: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v.dn= Longontsteking%20due%20to%20Pseudomonas%20%28stoornis%29&informationRecipient.languageCode.c=nl

Een zoekopdracht in vrije vorm, zonder codesysteem of probleemcode, maakt gebruik van de MedlinePlus-zoekmachine (alleen in het Engels): https://connect.medlineplus.gov/application?mainSearchCriteria.v.dn=Type+2+Diabetes

Verzoeken om informatie over geneesmiddelen

MedlinePlus Connect biedt de beste overeenkomsten met geneesmiddelinformatie bij het ontvangen van een RXCUI. Het geeft ook goede resultaten bij het ontvangen van een NDC-code. MedlinePlus Connect kan antwoorden op medicatiecodeverzoeken in het Engels of Spaans geven en zal een link terugsturen naar een resultatenpagina met de beste overeenkomsten uit de MedlinePlus-medicijninformatie.

Voor verzoeken om Engelse medicatie-informatie, als u geen NDC- of RXCUI-code verzendt of als we geen overeenkomst vinden op basis van de code, gebruiken we de tekstreeks die u verzendt om de beste overeenkomst met medicijninformatie weer te geven. Voor verzoeken om Spaanse medicatie-informatie reageert MedlinePlus Connect alleen op NDC's of RXCUI's; het gebruikt geen tekenreeksen. Het is mogelijk om een ​​antwoord in het Engels te krijgen, maar geen antwoord in het Spaans.

Er kunnen meerdere reacties zijn op één medicatieverzoek. Er is mogelijk niet altijd een match voor elk verzoek. Als MedlinePlus Connect een null-reactie op een medicijnverzoek vindt, geeft het programma een zoekvak weer voor de MedlinePlus-site. Een gebruiker kan een medicijnnaam intypen en krijgt mogelijk een goed antwoord.

Voor verzoeken om informatie over geneesmiddelen is de basis-URL: https://connect.medlineplus.gov/application

Verzoeken om Engelse en Spaanse medicatie-informatie hebben verschillende vereisten. Voeg deze gegevens toe om een ​​verzoek te verzenden:

1. Identificeer het type medicatiecode dat u verzendt. (Vereist voor Engels en Spaans)
   

   Voor RXCUI-gebruik:

   mainSearchCriteria.v.cs=2.16.840.1.113883.6.88

   Voor NDC-gebruik:

   mainSearchCriteria.v.cs=2.16.840.1.113883.6.69

2. Identificeer de daadwerkelijke code die u probeert op te zoeken. (Voorkeur voor Engels, Vereist voor Spaans)
   mainSearchCriteria.v.c=637188
3. Identificeer de naam van het medicijn met een tekstreeks. (Optioneel voor Engels, niet gebruikt voor Spaans)
   mainSearchCriteria.v.dn=Chantix 0,5 MG orale tablet

Voor Engelse verzoeken dient u minimaal het codesysteem en de code, of het codesysteem en de naam van het medicijn te identificeren. Stuur ze alle drie voor de beste resultaten voor Engelse verzoeken. Voor Spaanse verzoeken dient u het codesysteem en de code te identificeren.

Optionele parameters:

Bij het verzenden van een verzoek om Engelse informatie kunt u de optionele parameter van de naam van het medicijn opnemen. Dit wordt gedetailleerd beschreven in het bovenstaande gedeelte. Deze parameter wordt niet gebruikt voor Spaanse verzoeken.

Geef aan of u het verzoek in het Engels of Spaans wilt hebben. MedlinePlus Connect gaat ervan uit dat Engels de taal is als dit niet is opgegeven.

Als u wilt dat het antwoord op het opzoeken van de medicatiecode in het Spaans is, gebruik dan: informationRecipient.languageCode.c=es (=sp ook geaccepteerd)

Gebruik het volgende om Engels op te geven: informationRecipient.languageCode.c=en

Voorbeelden van verzoeken om medicijncodes

Uw verzoek om informatie over geneesmiddelen moet er als volgt uitzien.

Om informatie door een RXCUI op te vragen, moet uw verzoek er als volgt uitzien: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.88&mainSearchCriteria.vc=%20637188%20&mainSearchCriteria.v.dn =Chantix%200.5%20MG%20Oral%20Tablet&informationRecipient.languageCode.c=nl

Als u informatie wilt aanvragen bij een NDC voor een Spaanssprekende, moet uw verzoek er als volgt uitzien: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=%2000310-0751 -39&informationRecipient.languageCode.c=es

Als u een tekstreeks wilt verzenden zonder medicatiecode, moet u uw vraag identificeren als een NDC-verzoek, zodat MedlinePlus Connect weet dat u op zoek bent naar medicatie-informatie. Dit werkt alleen voor Engels. Uw verzoek kan er als volgt uitzien: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.v.dn=Chantix%200.5%20MG%20Oral%20Tablet&informationRecipient.languageCode.c =en

Verzoeken om informatie over laboratoriumtests

MedlinePlus Connect biedt overeenkomsten met laboratoriumtestinformatie bij ontvangst van een LOINC-verzoek. MedlinePlus Connect kan antwoorden op laboratoriumtestverzoeken in het Engels of Spaans geven en zal een link terugsturen naar een resultatenpagina met de beste overeenkomsten uit de MedlinePlus laboratoriumtestinformatie.

Voor verzoeken om informatie over laboratoriumtests is de basis-URL: https://connect.medlineplus.gov/application

Dit zijn twee vereiste parameters voor elke labtestquery naar deze toepassing:

1. Identificeer dat u het LINC-codesysteem gebruikt.
   

   Gebruik voor LOINC:

   mainSearchCriteria.v.cs=2.16.840.1.113883.6.1

   MedlinePlus Connect accepteert ook:

   mainSearchCriteria.v.cs=2.16.840.1.113883.11.79

2. Identificeer de daadwerkelijke code die u probeert op te zoeken.
   mainSearchCriteria.v.c=3187-2

Optionele parameters:

Identificeer de naam/titel van de laboratoriumtest. Deze informatie heeft echter geen invloed op de reactie. mainSearchCriteria.v.dn=Factor IX-test

Geef aan of u het verzoek in het Engels of Spaans wilt hebben. MedlinePlus Connect gaat ervan uit dat Engels de taal is als dit niet is opgegeven.

Als u wilt dat het antwoord op het opzoeken van de probleemcode in het Spaans is, gebruik dan: informationRecipient.languageCode.c=es (=sp ook geaccepteerd)

Gebruik het volgende om Engels op te geven: informationRecipient.languageCode.c=en

Een zoekopdracht in vrije vorm, zonder codesysteem of labcode, maakt gebruik van de MedlinePlus-zoekmachine. Deze aanpak is effectiever bij diagnoses (zie de informatie over de probleemcode hierboven) in plaats van tekstreeksen voor laboratoriumtests. Uw verzoek om laboratoriumtestinformatie moet er als volgt uitzien.

Voorbeelden van aanvragen voor laboratoriumtests

Als u informatie wilt aanvragen voor een Engelstalige spreker, kan uw verzoek er als volgt uitzien: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn=Factor%20IX%20assay&informationRecipient.languageCode.c=en https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.languageCode.c =en

Als u informatie wilt aanvragen voor een Spaanssprekende, kan uw verzoek er als volgt uitzien: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn=Factor%20IX%20assay&informationRecipient.languageCode.c=es https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.languageCode.c =es

Aanvaardbaar gebruik beleid

Om overbelasting van de MedlinePlus-servers te voorkomen, vereist NLM dat gebruikers van MedlinePlus Connect niet meer dan 100 verzoeken per minuut per IP-adres verzenden. Verzoeken die deze limiet overschrijden, worden niet behandeld en de service wordt pas na 300 seconden hersteld of totdat de aanvraagsnelheid onder de limiet komt, afhankelijk van wat later komt. Om het aantal verzoeken dat u naar Connect stuurt te beperken, raadt NLM aan om de resultaten gedurende een periode van 12-24 uur in de cache op te slaan.

Dit beleid is opgesteld om ervoor te zorgen dat de service beschikbaar en toegankelijk blijft voor alle gebruikers. Neem contact met ons op als u een specifiek gebruiksscenario heeft waarbij u een groot aantal verzoeken naar MedlinePlus Connect moet sturen en dus de in dit beleid beschreven limiet voor het aantal verzoeken moet overschrijden. NLM-medewerkers zullen uw verzoek beoordelen en bepalen of een uitzondering kan worden toegestaan. Raadpleeg ook de documentatie van de MedlinePlus XML-bestanden. Deze XML-bestanden bevatten volledige dossiers over gezondheidsonderwerpen en kunnen dienen als een alternatieve methode om toegang te krijgen tot MedlinePlus-gegevens.

Meer informatie