MedlinePlus Connect : 웹 서비스

콘텐츠

• 웹 서비스 개요
• 출력 매개 변수
• 진단 요청 (문제) 코드
• 선택적 매개 변수
• 문제 코드 요청에 대한 응답으로 선택된 Atom 요소 (또는 JSON 개체)에 대한 설명
• 문제 코드 요청의 예
• 관련 서비스 및 파일
• 약물 정보 요청
• 선택적 매개 변수
• 약물 요청에 대한 응답으로 선택된 Atom 요소 (또는 JSON 개체)에 대한 설명
• 약물 코드 요청의 예
• 랩 테스트 정보 요청
• 선택적 매개 변수
• 랩 테스트 요청에 대한 응답으로 선택된 Atom 요소 (또는 JSON 객체)에 대한 설명
• 랩 테스트 요청의 예
• 허용되는 사용 정책
• 추가 정보

MedlinePlus Connect는 웹 애플리케이션 또는 웹 서비스로 제공됩니다. 다음은 다음을 기반으로 요청에 응답하는 웹 서비스를 구현하기위한 기술 세부 정보입니다.

MedlinePlus Connect에서 반환 된 데이터에 연결하고 표시 할 수 있습니다. MedlinePlus 페이지를 귀하의 사이트에 복사 할 수 없습니다. MedlinePlus Connect 웹 서비스의 데이터를 사용하는 경우 해당 정보가 MedlinePlus.gov에서 제공되었지만 MedlinePlus 로고를 사용하지 않거나 MedlinePlus가 귀하의 특정 제품을 보증한다는 것을 암시하십시오. 자세한 지침은 NLM의 API 페이지를 참조하십시오. 이 서비스 외부에서 MedlinePlus 콘텐츠에 연결하는 방법에 대한 자세한 내용은 연결에 대한 지침 및 지침을 참조하십시오.

MedlinePlus Connect를 사용하기로 결정한 경우 이메일 목록에 등록하여 개발 상황을 파악하고 동료와 아이디어를 교환하십시오. MedlinePlus Connect를 구현하는 경우 당사에 연락하여 알려주십시오.

웹 서비스 개요

웹 서비스 요청에 대한 매개 변수는 HL7 Context-Aware Knowledge Retrieval (Infobutton) 지식 요청 URL 기반 구현 가이드를 따릅니다. REST 기반 응답은 HL7 Context-Aware Knowledge Retrieval (Infobutton) 서비스 지향 아키텍처 구현 가이드를 따릅니다. 요청의 출력은 Atom 피드 형식, JSON 또는 JSONP의 XML 일 수 있습니다.

요청 구조는 전송중인 코드 유형을 나타냅니다. 모든 경우에 웹 서비스의 기본 URL은 다음과 같습니다. https://connect.medlineplus.gov/service

MedlinePlus Connect는 HTTPS 연결을 사용합니다. HTTP 요청은 허용되지 않으며 HTTP를 사용하는 기존 구현은 HTTPS로 업데이트되어야합니다.

출력 매개 변수

이러한 매개 변수는 선택 사항입니다. 생략하면 기본 응답은 XML 형식의 영어 정보입니다.

언어
응답을 영어 또는 스페인어로 원하는지 확인하십시오. MedlinePlus Connect는 영어가 지정되지 않은 경우 해당 언어로 간주합니다.

문제 코드 조회에 대한 응답을 스페인어로하려면 다음을 사용하십시오. informationRecipient.languageCode.c = es
(= sp도 허용됨)

영어를 지정하려면 다음을 사용하십시오. informationRecipient.languageCode.c = en

체재
응답 형식이 XML, JSON 또는 JSONP인지 식별하십시오. XML이 기본값입니다.

JSON을 요청하려면 다음을 사용하십시오.

knowledgeResponseType = application / json

JSONP의 경우 다음을 사용하십시오.

knowledgeResponseType = application / javascript & callback = CallbackFunction 여기서 CallbackFunction은 콜백 함수에 부여한 이름입니다.

XML 응답의 경우 다음을 사용하십시오.

knowledgeResponseType = text / xml 또는 knowledgeResponseType 매개 변수는 요청에서 제외됩니다.

진단 요청 (문제) 코드

문제 코드의 경우 MedlinePlus Connect는 MedlinePlus 건강 주제 페이지, 유전학 페이지 또는 다른 NIH 기관의 페이지에서 링크 및 정보를 반환합니다.

MedlinePlus Connect는 다음을 반환합니다.

각 코드가 항상 일치하는 것은 아닙니다. 이러한 경우 MedlinePlus Connect는 null 응답을 반환합니다.

서비스의 기본 URL : https://connect.medlineplus.gov/service

이 서비스에 대한 쿼리에는 두 가지 필수 매개 변수가 있습니다.

1. 코드 시스템
   사용할 문제 코드 시스템을 식별하십시오.

   ICD-10-CM의 경우 :

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.90

   ICD-9-CM의 경우 :

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.103

   SNOMED CT의 경우 :

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.96

2. 암호
   조회하려는 실제 코드를 식별하십시오.
   mainSearchCriteria.v.c = 250.33

선택적 매개 변수

코드 제목
문제 코드의 이름 / 제목을 식별 할 수도 있습니다. 그러나이 정보는 응답에 영향을 미치지 않습니다 (이름 / 제목 정보가 사용될 수있는 MedlinePlus Connect 웹 응용 프로그램과 달리). mainSearchCriteria.v.dn = 통제되지 않은 다른 혼수 상태 1 형 당뇨병을 동반 한 당뇨병 언어 및 출력 형식에 대한 자세한 내용은 출력 매개 변수에 대한 위 섹션을 참조하십시오.

문제 코드 요청에 대한 응답으로 선택된 Atom 요소 (또는 JSON 개체)에 대한 설명

문제 코드 요청의 예

스페인어를 사용하는 환자에 대해 제어되지 않은 다른 혼수 상태 1 형 ICD-9 코드 250.33이있는 당뇨병 Mellitus에 대한 전체 요청은 다음 URL 주소를 갖습니다. https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103 & mainSearchCriteria.vc = 250.33 & mainSearchCriteria.v.dn = 당뇨병 % 20mellitus % 20with % 20other % 20coma % 20type % 201 % 20unmanaged & informationRecipient.languageCode.c = es

진단이 동일하지만 요청 된 형식은 JSON이고 언어는 영어 인 환자 : https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application / json

SNOMED CT 코드 41381004를 사용하여 "Pseudomonas로 인한 폐렴"진단을받은 환자 : https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v.dn= Pneumonia % 20due % 20to % 20Pseudomonas % 20 % 28disorder % 29 & informationRecipient.languageCode.c = en

진단이 동일하지만 요청 된 형식이 JSONP 인 환자 : https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javascript&callback=CallbackFunction

관련 서비스 및 파일

문제 코드가 아닌 텍스트 요청에 대한 응답으로 MedlinePlus 건강 주제를 수신하려면 MedlinePlus 웹 서비스를 조사하십시오. 또한 XML 형식의 MedlinePlus 건강 주제 전체 세트가 필요한 경우 XML 파일 페이지를 참조하십시오.

약물 정보 요청

MedlinePlus Connect는 RXCUI를받을 때 일치하는 최상의 약품 정보를 제공합니다. 또한 NDC 코드를받을 때 좋은 결과를 제공합니다. MedlinePlus Connect는 영어 또는 스페인어로 답변을 제공 할 수 있습니다.

영어 약물 정보 요청의 경우, NDC 또는 RXCUI를 보내지 않거나 코드를 기반으로 일치하는 항목이없는 경우 애플리케이션은 가장 일치하는 약물 정보를 표시하기 위해 보낸 텍스트 문자열을 사용합니다. 스페인 의약품 정보 요청의 경우 MedlinePlus Connect는 NDC 또는 RXCUI에만 응답하며 텍스트 문자열을 사용하지 않습니다. 영어로 응답이 가능하지만 스페인어로 응답이 없습니다.

MedlinePlus Connect 웹 서비스는 다음을 반환합니다.

하나의 약물 요청에 대해 여러 응답이있을 수 있습니다. 각 요청에 대해 항상 일치하는 것은 아닙니다. 이러한 경우 MedlinePlus Connect는 null 응답을 반환합니다.

약물 정보 요청의 경우 기본 URL은 다음과 같습니다. https://connect.medlineplus.gov/service

요청을 보내려면 다음 정보를 포함하십시오.

1. 코드 시스템
   보내는 약물 코드의 유형을 확인하십시오. (영어 및 스페인어 필수)
   

   RXCUI의 경우 :

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88

   NDC 사용 :

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69

   MedlinePlus Connect는 영어로 된 약물 정보 요청에 대한 텍스트 문자열을 수락 할 수도 있지만 위에 나열된 두 가지 코드 시스템 중 하나를 포함하여 약물 정보를 찾고 있음을 나타내야합니다.
2. 암호
   조회하려는 실제 코드를 식별하십시오. (영어 선호, 스페인어 필수)
   mainSearchCriteria.v.c = 637188
3. 약물 이름
   텍스트 문자열로 약물 이름을 식별하십시오. (영어의 경우 선택 사항, 스페인어에는 사용되지 않음)
   mainSearchCriteria.v.dn = Chantix 0.5 MG 경구 정제

선택적 매개 변수

영어 정보 요청을 보낼 때 약물 이름의 선택적 매개 변수를 포함 할 수 있습니다. 이것은 위 섹션에서 자세히 설명합니다. mainSearchCriteria.v.dn = Chantix 0.5 MG 경구 정제

언어 및 출력 형식에 대한 자세한 내용은 위의 출력 매개 변수 섹션을 참조하십시오.

약물 요청에 대한 응답으로 선택된 Atom 요소 (또는 JSON 개체)에 대한 설명

약물 코드 요청의 예

귀하의 약품 정보 요청은 다음 중 하나와 유사해야합니다.

RXCUI로 정보를 요청하려면 다음과 같이 요청해야합니다. 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 = en

NDC에서 스페인어 사용자를 위해 정보를 요청하려면 다음과 같이 요청해야합니다. https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-0751- 39 & informationRecipient.languageCode.c = es

투약 코드없이 텍스트 문자열을 보내려면 MedlinePlus Connect가 투약 정보를 찾고 있음을 알 수 있도록 쿼리를 NDC 유형 요청으로 식별해야합니다. 이것은 영어 요청에만 적용됩니다. 요청은 다음과 같습니다. 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 = en

랩 테스트 정보 요청

MedlinePlus Connect는 LOINC 요청을받을 때 실험실 테스트 정보와 일치하는 정보를 제공합니다. 이 서비스는 영어 또는 스페인어로 응답을 제공 할 수 있습니다.

MedlinePlus Connect 웹 서비스는 다음을 반환합니다.

각 코드가 항상 일치하는 것은 아닙니다. 이러한 경우 MedlinePlus Connect는 null 응답을 반환합니다.

서비스의 기본 URL : https://connect.medlineplus.gov/service

이 서비스에 대한 랩 테스트 쿼리에 필요한 두 가지 매개 변수는 다음과 같습니다.

1. 코드 시스템
   

   LOINC 코드 시스템을 사용하고 있는지 확인하십시오. 사용하다:

   mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1

   MedlinePlus Connect는 다음 사항도 허용합니다.

   mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79

2. 암호
   조회하려는 실제 코드를 식별하십시오.
   mainSearchCriteria.v.c = 3187-2

선택적 매개 변수

실험실 테스트의 이름을 확인할 수도 있습니다. 그러나이 정보는 응답에 영향을주지 않습니다. mainSearchCriteria.v.dn = Factor IX 분석

언어 및 출력 형식에 대한 자세한 내용은 위의 출력 매개 변수 섹션을 참조하십시오.

랩 테스트 요청에 대한 응답으로 선택된 Atom 요소 (또는 JSON 객체)에 대한 설명

랩 테스트 요청의 예

영어 사용자에 대한 정보를 요청하려면 https://connect.medlineplus.gov/service?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/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.languageCode.c = en

스페인어 사용자에 대한 정보를 요청하려면 https://connect.medlineplus.gov/service?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/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.languageCode.c = es

허용되는 사용 정책

MedlinePlus 서버의 과부하를 방지하기 위해 NLM은 MedlinePlus Connect 사용자가 IP 주소 당 분당 100 개 이하의 요청을 보내도록 요구합니다. 이 한도를 초과하는 요청은 처리되지 않으며 300 초 동안 또는 요청 속도가 한도 이하로 떨어질 때까지 서비스가 복원되지 않습니다. Connect로 보내는 요청 수를 제한하기 위해 NLM은 12-24 시간 동안 결과 캐싱을 권장합니다.

이 정책은 모든 사용자가 서비스를 계속 사용할 수 있고 액세스 할 수 있도록하기위한 것입니다. MedlinePlus Connect에 많은 수의 요청을 보내야하는 특정 사용 사례가있어이 정책에 설명 된 요청 속도 제한을 초과하는 경우 당사에 문의하십시오. NLM 직원이 귀하의 요청을 평가하고 예외가 허용 될 수 있는지 결정합니다. MedlinePlus XML 파일 문서도 검토하십시오. 이 XML 파일은 완전한 건강 주제 기록을 포함하며 MedlinePlus 데이터에 액세스하는 대체 방법으로 사용할 수 있습니다.

추가 정보