MedlinePlus Connect: aplikacja internetowa

Zawartość

• Przegląd aplikacji internetowych
• Żądania kodów diagnostycznych (problemów)
• Parametry opcjonalne
• Przykłady próśb o kody problemów
• Prośby o informacje o narkotykach
• Parametry opcjonalne
• Przykłady próśb o kody leków
• Prośby o informacje o testach laboratoryjnych
• Parametry opcjonalne
• Przykłady wniosków o testy laboratoryjne
• Przyjęte zasady użytkowania
• Więcej informacji

MedlinePlus Connect jest dostępny jako aplikacja internetowa lub usługa sieciowa. Poniżej znajdują się szczegóły techniczne dotyczące wdrożenia aplikacji internetowej, która odpowiada na zapytania na podstawie:

Jeśli zdecydujesz się korzystać z MedlinePlus Connect, zarejestruj się na listę e-mailową, aby być na bieżąco i wymieniać się pomysłami z kolegami. Poinformuj nas, czy wdrażasz MedlinePlus Connect, kontaktując się z nami. Zapraszamy do łączenia się i wyświetlania danych dostarczonych przez MedlinePlus Connect. Aby uzyskać więcej informacji na temat łączenia się z treścią MedlinePlus poza tą usługą, zapoznaj się z naszymi wytycznymi i instrukcjami dotyczącymi łączenia.

Przegląd aplikacji internetowych

Interfejs API dla aplikacji sieci Web jest zgodny ze specyfikacją HL7 Context-Aware Knowledge Retrieval (Infobutton) Knowledge Request-Based Implementation. Struktura żądania wskazuje, jakiego rodzaju kod wysyłasz. We wszystkich przypadkach bazowy adres URL aplikacji internetowej to: https://connect.medlineplus.gov/application

MedlinePlus Connect korzysta z połączeń HTTPS. Żądania HTTP nie będą akceptowane, a istniejące implementacje korzystające z protokołu HTTP powinny zostać zaktualizowane do protokołu HTTPS.

Żądania kodów diagnostycznych (problemów)

MedlinePlus Connect dopasowuje kody ICD-10-CM, ICD-9-CM lub SNOMED CT do powiązanych stron z tematami medycznymi MedlinePlus, genetyki lub stron z innych instytutów NIH. Na przykład pacjentowi, u którego zdiagnozowano ICD-9-CM kod 493.12, Astma zewnętrzna z zaostrzeniem, może zostać przedstawiony link w elektronicznej karcie zdrowia (EHR), który prowadzi do strony MedlinePlus Astma.

Ten link wyświetla stronę z pustym polem wyszukiwania. Dla każdego zapytania do tej aplikacji wymagane są dwa parametry:

1. Zidentyfikuj system kodów problemów, którego będziesz używać.
   

   Dla ICD-10-CM użyj:

   mainSearchCriteria.v.cs=2.16.840.1.113883.6.90

   Do użytku z ICD-9-CM:

   główne KryteriaWyszukiwania.v.cs=2.16.840.1.113883.6.103

   Dla SNOMED CT użyj:

   mainSearchCriteria.v.cs=2.16.840.1.113883.6.96

2. Zidentyfikuj rzeczywisty kod, który próbujesz wyszukać:
   główne KryteriaWyszukiwania.v.c=250,33

Parametry opcjonalne

Określ nazwę/tytuł kodu problemu. Wysłanie żadnego kodu spowoduje zapytanie do wyszukiwarki MedlinePlus. Jeśli określisz kod i nazwę/tytuł kodu, ale MedlinePlus Connect nie ma wyników, strona odpowiedzi wyświetli pole wyszukiwania MedlinePlus wypełnione wstępnie nazwą/tytułem. mainSearchCriteria.v.dn=Cukrzyca z inną niekontrolowaną śpiączką typu 1

Określ, czy chcesz, aby prośba była w języku angielskim czy hiszpańskim. MedlinePlus Connect zakłada, że ​​język angielski jest językiem, jeśli nie został określony.

Jeśli chcesz, aby odpowiedź na wyszukiwanie kodu problemu była w języku hiszpańskim, użyj: informationRecipient.languageCode.c=es
(=sp również akceptowane)

Aby określić język angielski, użyj następującego: informationRecipient.languageCode.c=en

Przykłady próśb o kody problemów

Kompletna prośba o Diabetes Mellitus z inną niekontrolowaną śpiączką typu 1, kod ICD-9 250.33, dla pacjenta hiszpańskojęzycznego, miałaby następujący adres URL: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103&mainSearchCriteria.vc=250.33&mainSearchCriteria.v.dn=Cukrzyca%20mellitus%20with%20other%20coma%20type%201%20niekontrolowane&informacjeRecipient.languageCode.c=es

Pacjent ze zdiagnozowanym „zapaleniem płuc wywołanym przez Pseudomonas” przy użyciu kodu SNOMED CT 41381004: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v.dn= Zapalenie płuc%20należy%20to%20Pseudomonas%20%28zaburzenie%29&informacjeOdbiorca.languageCode.c=en

Zapytanie o dowolnej formie, bez systemu kodu lub kodu problemu, będzie korzystać z wyszukiwarki MedlinePlus (tylko w języku angielskim): https://connect.medlineplus.gov/application?mainSearchCriteria.v.dn=Type+2+Diabetes

Prośby o informacje o narkotykach

MedlinePlus Connect zapewnia najlepsze dopasowanie informacji o leku podczas odbierania RXCUI. Zapewnia również dobre wyniki podczas odbierania kodu NDC. MedlinePlus Connect może udzielać odpowiedzi na prośby o kod leków w języku angielskim lub hiszpańskim i zwraca łącze do strony wyników z najlepszymi dopasowaniami z informacji o leku MedlinePlus.

W przypadku próśb o informacje o lekach w języku angielskim, jeśli nie wyślesz kodu NDC lub RXCUI lub jeśli nie znajdziemy dopasowania na podstawie kodu, użyjemy wysłanego przez Ciebie ciągu tekstowego, aby wyświetlić najlepsze dopasowanie informacji o leku. W przypadku próśb o hiszpańskie informacje o lekach, MedlinePlus Connect odpowiada tylko na NDC lub RXCUI; nie używa ciągów tekstowych. Możliwe jest otrzymanie odpowiedzi w języku angielskim, ale brak odpowiedzi w języku hiszpańskim.

Na jedno żądanie leku może być wiele odpowiedzi. Nie zawsze może być dopasowanie do każdego żądania. Jeśli MedlinePlus Connect znajdzie pustą odpowiedź na prośbę o lek, program wyświetli pole wyszukiwania dla witryny MedlinePlus. Użytkownik może wpisać nazwę leku i otrzymać dobrą odpowiedź.

W przypadku próśb o informacje o leku, podstawowy adres URL to: https://connect.medlineplus.gov/application

Prośby o informacje o lekach w języku angielskim i hiszpańskim mają różne wymagania. Aby wysłać zapytanie, dołącz następujące informacje:

1. Określ rodzaj wysyłanego kodu leku. (Wymagane dla języka angielskiego i hiszpańskiego)
   

   Do użytku RXCUI:

   mainSearchCriteria.v.cs=2.16.840.1.113883.6.88

   Do użytku NDC:

   mainSearchCriteria.v.cs=2.16.840.1.113883.6.69

2. Zidentyfikuj rzeczywisty kod, który próbujesz wyszukać. (Preferowany w języku angielskim, wymagany w przypadku hiszpańskiego)
   główne KryteriaWyszukiwania.v.c=637188
3. Zidentyfikuj nazwę leku za pomocą ciągu tekstowego. (Opcjonalne dla języka angielskiego, nie używane dla hiszpańskiego)
   mainSearchCriteria.v.dn=Chantix 0,5 MG tabletka doustna

W przypadku wniosków w języku angielskim należy określić co najmniej system kodów i kod lub system kodów i nazwę leku. Wyślij wszystkie trzy, aby uzyskać najlepsze wyniki dla próśb w języku angielskim. W przypadku wniosków w języku hiszpańskim należy zidentyfikować system kodów i kod.

Parametry opcjonalne

Wysyłając prośbę o informacje w języku angielskim, możesz dołączyć opcjonalny parametr nazwy leku. Jest to szczegółowo opisane w powyższej sekcji. Ten parametr nie jest używany w przypadku żądań hiszpańskich.

Określ, czy chcesz, aby prośba była w języku angielskim czy hiszpańskim. MedlinePlus Connect zakłada, że ​​język angielski jest językiem, jeśli nie został określony.

Jeśli chcesz, aby odpowiedź na wyszukiwanie kodu leku była w języku hiszpańskim, użyj: informationRecipient.languageCode.c=es (=sp również akceptowane)

Aby określić język angielski, użyj następującego: informationRecipient.languageCode.c=en

Przykłady próśb o kody leków

Twoja prośba o informacje o leku powinna wyglądać jak jedna z poniższych.

Aby zażądać informacji przez RXCUI, Twoja prośba powinna wyglądać tak: 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&informacjeRecipient.languageCode.c=en

Aby poprosić NDC o informacje dla osoby mówiącej po hiszpańsku, Twoja prośba powinna wyglądać tak: https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=%2000310-0751 -39&informacjeRecipient.languageCode.c=es

Aby wysłać ciąg tekstowy bez kodu leku, należy zidentyfikować zapytanie jako żądanie typu NDC, aby MedlinePlus Connect wiedział, że szukasz informacji o lekach. Będzie to działać tylko w języku angielskim. Twoje żądanie może wyglądać tak: 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

Prośby o informacje o testach laboratoryjnych

MedlinePlus Connect zapewnia dopasowanie do informacji z badań laboratoryjnych po otrzymaniu żądania LOINC. MedlinePlus Connect może dostarczać odpowiedzi na prośby o testy laboratoryjne w języku angielskim lub hiszpańskim i zwraca łącze do strony wyników z najlepszymi dopasowaniami z informacji o testach laboratoryjnych MedlinePlus.

W przypadku próśb o informacje z badań laboratoryjnych, podstawowy adres URL to: https://connect.medlineplus.gov/application

Oto dwa wymagane parametry dla każdego zapytania dotyczącego testu laboratoryjnego do tej aplikacji:

1. Zidentyfikuj, że używasz systemu kodów LOINC.
   

   Do użytku LOINC:

   mainSearchCriteria.v.cs=2.16.840.1.113883.6.1

   MedlinePlus Connect akceptuje również:

   główne KryteriaWyszukiwania.v.cs=2.16.840.1.113883.11.79

2. Zidentyfikuj rzeczywisty kod, który próbujesz wyszukać.
   główne KryteriaWyszukiwania.v.c=3187-2

Parametry opcjonalne

Określ nazwę/tytuł testu laboratoryjnego. Jednak ta informacja nie ma wpływu na odpowiedź. mainSearchCriteria.v.dn=Test czynnika IX

Określ, czy chcesz, aby prośba była w języku angielskim czy hiszpańskim. MedlinePlus Connect zakłada, że ​​język angielski jest językiem, jeśli nie został określony.

Jeśli chcesz, aby odpowiedź na wyszukiwanie kodu problemu była w języku hiszpańskim, użyj: informationRecipient.languageCode.c=es (=sp również akceptowane)

Aby określić język angielski, użyj następującego: informationRecipient.languageCode.c=en

Zapytanie o dowolnej formie, bez systemu kodowania lub kodu laboratoryjnego, będzie korzystać z wyszukiwarki MedlinePlus. Takie podejście jest bardziej efektywne w przypadku diagnoz (zobacz informacje o kodzie problemu powyżej) zamiast ciągów tekstowych testów laboratoryjnych. Twoja prośba o informacje dotyczące testu laboratoryjnego powinna wyglądać jak jedna z poniższych.

Przykłady wniosków o testy laboratoryjne

Aby poprosić o informacje dla osoby mówiącej po angielsku, Twoja prośba może wyglądać następująco: 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

Aby poprosić o informacje dla osoby mówiącej po hiszpańsku, Twoja prośba może wyglądać następująco: 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

Przyjęte zasady użytkowania

Aby uniknąć przeciążenia serwerów MedlinePlus, NLM wymaga, aby użytkownicy MedlinePlus Connect wysyłali nie więcej niż 100 żądań na minutę na adres IP. Żądania przekraczające ten limit nie będą obsługiwane, a usługa nie zostanie przywrócona przez 300 sekund lub do czasu, gdy częstotliwość żądań spadnie poniżej limitu, w zależności od tego, co nastąpi później. Aby ograniczyć liczbę żądań wysyłanych do Connect, NLM zaleca buforowanie wyników przez okres 12-24 godzin.

Ta polityka ma na celu zapewnienie, że usługa pozostanie dostępna i dostępna dla wszystkich użytkowników. Jeśli masz konkretny przypadek użycia, który wymaga wysłania dużej liczby żądań do MedlinePlus Connect, a tym samym przekroczenia limitu liczby żądań określonego w niniejszych zasadach, skontaktuj się z nami. Personel NLM oceni Twoją prośbę i określi, czy można przyznać wyjątek. Prosimy również o zapoznanie się z dokumentacją plików XML MedlinePlus. Te pliki XML zawierają pełne rekordy tematów zdrowotnych i mogą służyć jako alternatywna metoda dostępu do danych MedlinePlus.

Więcej informacji