MedlinePlus Connect : 웹 애플리케이션
콘텐츠
- 웹 애플리케이션 개요
- 진단 요청 (문제) 코드
- 선택적 매개 변수
- 문제 코드 요청의 예
- 약물 정보 요청
- 선택적 매개 변수
- 약물 코드 요청의 예
- 랩 테스트 정보 요청
- 선택적 매개 변수
- 랩 테스트 요청의 예
- 허용되는 사용 정책
- 추가 정보
MedlinePlus Connect는 웹 애플리케이션 또는 웹 서비스로 제공됩니다. 다음은 다음을 기반으로 요청에 응답하는 웹 응용 프로그램을 구현하기위한 기술 세부 정보입니다.
MedlinePlus Connect를 사용하기로 결정한 경우 이메일 목록에 등록하여 개발 상황을 파악하고 동료와 아이디어를 교환하십시오. MedlinePlus Connect를 구현하는 경우 당사에 연락하여 알려주십시오. MedlinePlus Connect에서 제공하는 데이터에 연결하고 표시 할 수 있습니다. 이 서비스 외부에서 MedlinePlus 콘텐츠에 연결하는 방법에 대한 자세한 내용은 연결에 대한 지침 및 지침을 참조하십시오.
웹 애플리케이션 개요
웹 애플리케이션 용 API는 HL7 컨텍스트 인식 지식 검색 (Infobutton) 지식 요청 URL 기반 구현 사양을 준수합니다. 요청 구조는 전송중인 코드 유형을 나타냅니다. 모든 경우에 웹 애플리케이션의 기본 URL은 https://connect.medlineplus.gov/application입니다.
MedlinePlus Connect는 HTTPS 연결을 사용합니다. HTTP 요청은 허용되지 않으며 HTTP를 사용하는 기존 구현은 HTTPS로 업데이트되어야합니다.
진단 요청 (문제) 코드
MedlinePlus Connect는 ICD-10-CM, ICD-9-CM 또는 SNOMED CT 코드를 관련 MedlinePlus 건강 주제 페이지, 유전학 페이지 또는 다른 NIH 기관의 페이지와 일치시킵니다. 예를 들어, ICD-9-CM 코드 493.12, 악화를 동반 한 외인성 천식 진단을받은 환자는 MedlinePlus 페이지 천식으로 이어지는 전자 건강 기록 (EHR)의 링크를 제시 할 수 있습니다.
문제 별 요청의 경우 애플리케이션의 기본 URL : https://connect.medlineplus.gov/application이 링크는 빈 검색 창이있는 페이지를 표시합니다. 이 애플리케이션에 대한 쿼리에는 두 가지 필수 매개 변수가 있습니다.
- 사용할 문제 코드 시스템을 식별하십시오.
- 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
- 조회하려는 실제 코드를 식별하십시오.
mainSearchCriteria.v.c = 250.33
선택적 매개 변수
문제 코드의 이름 / 제목을 식별하십시오. 코드를 보내지 않으면 MedlinePlus 검색 엔진에 쿼리가 발생합니다. 코드와 코드의 이름 / 제목을 지정했지만 MedlinePlus Connect에 결과가없는 경우 응답 페이지에 이름 / 제목이 미리 채워진 MedlinePlus 검색 상자가 표시됩니다. mainSearchCriteria.v.dn = 조절되지 않은 다른 혼수 상태 1 형 당뇨병이있는 당뇨병
요청을 영어 또는 스페인어로 원하는지 확인하십시오. MedlinePlus Connect는 영어가 지정되지 않은 경우 해당 언어로 간주합니다.
문제 코드 조회에 대한 응답을 스페인어로하려면 다음을 사용하십시오. informationRecipient.languageCode.c = es
(= sp도 허용됨)
영어를 지정하려면 다음을 사용하십시오. informationRecipient.languageCode.c = en
문제 코드 요청의 예
스페인어를 사용하는 환자에 대해 제어되지 않은 다른 혼수 상태 1 형 ICD-9 코드 250.33이있는 당뇨병 Mellitus에 대한 완전한 요청은 다음 URL 주소를 갖습니다. https://connect.medlineplus.gov/application?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
SNOMED CT 코드 41381004를 사용하여 "Pseudomonas로 인한 폐렴"진단을받은 환자 : https://connect.medlineplus.gov/application?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
코드 시스템이나 문제 코드가없는 자유 형식 쿼리는 MedlinePlus 검색 엔진 (영어로만 제공)을 사용합니다. https://connect.medlineplus.gov/application?mainSearchCriteria.v.dn=Type+2+Diabetes
약물 정보 요청
MedlinePlus Connect는 RXCUI를받을 때 일치하는 최상의 약품 정보를 제공합니다. 또한 NDC 코드를받을 때 좋은 결과를 제공합니다. MedlinePlus Connect는 약품 코드 요청에 대한 응답을 영어 또는 스페인어로 제공 할 수 있으며 MedlinePlus 약품 정보에서 가장 일치하는 결과 페이지 링크를 반환합니다.
영어 약품 정보 요청의 경우, NDC 또는 RXCUI 코드를 보내지 않거나 코드를 기반으로 일치하는 항목이없는 경우 귀하가 보낸 텍스트 문자열을 사용하여 최상의 약품 정보 일치를 표시합니다. 스페인 의약품 정보 요청의 경우 MedlinePlus Connect는 NDC 또는 RXCUI에만 응답합니다. 텍스트 문자열을 사용하지 않습니다. 영어로 답변이 가능하지만 스페인어로 답변이 없습니다.
하나의 약물 요청에 대해 여러 응답이있을 수 있습니다. 각 요청에 대해 항상 일치하는 것은 아닙니다. MedlinePlus Connect가 약물 요청에 대해 null 응답을 발견하면 프로그램은 MedlinePlus 사이트에 대한 검색 상자를 표시합니다. 사용자는 약물 이름을 입력 할 수 있으며 좋은 반응을 얻을 수 있습니다.
약물 정보 요청의 경우 기본 URL은 다음과 같습니다. https://connect.medlineplus.gov/application
영어 및 스페인어 약물 정보 요청에는 다른 요구 사항이 있습니다. 요청을 보내려면 다음 정보를 포함하십시오.
- 보내는 약물 코드의 유형을 확인하십시오. (영어 및 스페인어 필수)
- RXCUI의 경우 :
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.88
- NDC 사용 :
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.69
- 조회하려는 실제 코드를 식별하십시오. (영어 선호, 스페인어 필수)
mainSearchCriteria.v.c = 637188 - 텍스트 문자열로 약물 이름을 식별하십시오. (영어의 경우 선택 사항, 스페인어에는 사용되지 않음)
mainSearchCriteria.v.dn = Chantix 0.5 MG 경구 정제
영어 요청의 경우 최소한 코드 시스템과 코드 또는 코드 시스템과 약물 이름을 확인해야합니다. 영어 요청에 대한 최상의 결과를 얻으려면 세 가지를 모두 보내십시오. 스페인어 요청의 경우 코드 시스템과 코드를 식별해야합니다.
선택적 매개 변수
영어 정보 요청을 보낼 때 약물 이름의 선택적 매개 변수를 포함 할 수 있습니다. 이것은 위 섹션에서 자세히 설명합니다. 이 매개 변수는 스페인어 요청에 사용되지 않습니다.
요청을 영어 또는 스페인어로 원하는지 확인하십시오. MedlinePlus Connect는 영어가 지정되지 않은 경우 해당 언어로 간주합니다.
약품 코드 조회에 대한 응답을 스페인어로 받으려면 다음을 사용하십시오. informationRecipient.languageCode.c = es (= sp도 허용됨)
영어를 지정하려면 다음을 사용하십시오. informationRecipient.languageCode.c = en
약물 코드 요청의 예
귀하의 약품 정보 요청은 다음 중 하나와 유사해야합니다.
RXCUI로 정보를 요청하려면 다음과 같이 요청해야합니다. 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 = en
NDC에서 스페인어 사용자를 위해 정보를 요청하려면 다음과 같이 요청해야합니다. https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=%2000310-0751 -39 & informationRecipient.languageCode.c = es
투약 코드없이 텍스트 문자열을 보내려면 MedlinePlus Connect가 투약 정보를 찾고 있음을 알 수 있도록 쿼리를 NDC 유형 요청으로 식별해야합니다. 이것은 영어로만 작동합니다. 요청은 다음과 같습니다. 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
랩 테스트 정보 요청
MedlinePlus Connect는 LOINC 요청을받을 때 실험실 테스트 정보와 일치하는 정보를 제공합니다. MedlinePlus Connect는 영어 또는 스페인어로 실험실 테스트 요청에 대한 응답을 제공 할 수 있으며 MedlinePlus 실험실 테스트 정보에서 가장 일치하는 결과 페이지에 대한 링크를 반환합니다.
랩 테스트 정보 요청의 경우 기본 URL : https://connect.medlineplus.gov/application
다음은이 응용 프로그램에 대한 랩 테스트 쿼리에 필요한 두 가지 매개 변수입니다.
- LOINC 코드 시스템을 사용하고 있는지 확인하십시오.
- LOINC 사용 :
- mainSearchCriteria.v.cs = 2.16.840.1.113883.6.1
- MedlinePlus Connect는 다음 사항도 허용합니다.
- mainSearchCriteria.v.cs = 2.16.840.1.113883.11.79
- 조회하려는 실제 코드를 식별하십시오.
mainSearchCriteria.v.c = 3187-2
선택적 매개 변수
랩 테스트의 이름 / 제목을 확인합니다. 그러나이 정보는 응답에 영향을주지 않습니다. mainSearchCriteria.v.dn = Factor IX 분석
요청을 영어 또는 스페인어로 원하는지 확인하십시오. MedlinePlus Connect는 영어가 지정되지 않은 경우 해당 언어로 간주합니다.
문제 코드 조회에 대한 응답을 스페인어로 받으려면 다음을 사용하십시오. informationRecipient.languageCode.c = es (= sp도 허용됨)
영어를 지정하려면 다음을 사용하십시오. informationRecipient.languageCode.c = en
코드 시스템이나 랩 코드가없는 자유 형식 쿼리는 MedlinePlus 검색 엔진을 사용합니다. 이 접근 방식은 랩 테스트 텍스트 문자열 대신 진단 (위의 문제 코드 정보 참조)에 더 효과적입니다. 랩 테스트 정보 요청은 다음 중 하나와 유사해야합니다.
랩 테스트 요청의 예
영어 사용자에 대한 정보를 요청하려면 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
스페인어 사용자에 대한 정보를 요청하려면 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
허용되는 사용 정책
MedlinePlus 서버의 과부하를 방지하기 위해 NLM은 MedlinePlus Connect 사용자가 IP 주소 당 분당 100 개 이하의 요청을 보내도록 요구합니다. 이 한도를 초과하는 요청은 처리되지 않으며 300 초 동안 또는 요청 속도가 한도 이하로 떨어질 때까지 서비스가 복원되지 않습니다. Connect로 보내는 요청 수를 제한하기 위해 NLM은 12-24 시간 동안 결과 캐싱을 권장합니다.
이 정책은 모든 사용자가 서비스를 계속 사용할 수 있고 액세스 할 수 있도록하기위한 것입니다. MedlinePlus Connect에 많은 수의 요청을 보내야하는 특정 사용 사례가있어이 정책에 설명 된 요청 속도 제한을 초과하는 경우 당사에 문의하십시오. NLM 직원이 귀하의 요청을 평가하고 예외가 허용 될 수 있는지 결정합니다. MedlinePlus XML 파일 문서도 검토하십시오. 이 XML 파일은 완전한 건강 주제 기록을 포함하며 MedlinePlus 데이터에 액세스하는 대체 방법으로 사용할 수 있습니다.