MedlinePlus Connect:Web 应用程序
内容
MedlinePlus Connect 可用作 Web 应用程序或 Web 服务。以下是实现 Web 应用程序的技术细节,该应用程序响应基于以下条件的请求:
如果您决定使用 MedlinePlus Connect,请注册电子邮件列表以跟上发展并与您的同事交流想法。请通过联系我们告诉我们您是否实施 MedlinePlus Connect。欢迎您链接并显示 MedlinePlus Connect 提供的数据。有关如何在此服务之外链接到 MedlinePlus 内容的更多信息,请参阅我们的链接指南和说明。
Web 应用程序概述
Web 应用程序的 API 符合 HL7 上下文感知知识检索(信息按钮)知识请求基于 URL 的实现规范。请求的结构指示您发送的代码类型。在所有情况下,Web 应用程序的基本 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、外在性哮喘恶化的患者提供电子健康记录 (EHR) 中的链接,该链接指向 MedlinePlus 页面哮喘。
对于按问题提出的请求,应用程序的基本 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,将具有以下 URL 地址: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%20uncontrolled&informationRecipient.languageCode.c=es
使用 SNOMED CT 代码 41381004 诊断为“假单胞菌肺炎”的患者:https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381Cdnriteria.肺炎%20due%20to%20Pseudomonas%20%28disorder%29&informationRecipient.languageCode.c=en
无代码系统或问题代码的自由形式查询将使用 MedlinePlus 搜索引擎(仅英文):https://connect.medlineplus.gov/application?mainSearchCriteria.v.dn=Type+2+Diabetes
药品信息请求
当收到 RXCUI 时,MedlinePlus Connect 会提供最佳的药物信息匹配。它还在接收 NDC 代码时提供了良好的结果。 MedlinePlus Connect 可以用英语或西班牙语提供对药物代码请求的响应,并将返回一个指向结果页面的链接,其中包含来自 MedlinePlus 药物信息的最佳匹配。
对于英文药物信息的请求,如果您没有发送 NDC 或 RXCUI 代码,或者我们根据代码发现不匹配,我们将使用您发送的文本字符串来显示最佳药物信息匹配。对于西班牙药物信息请求,MedlinePlus Connect 仅响应 NDC 或 RXCUI;它不使用文本字符串。有可能有英文回复,但没有西班牙文回复。
对一个药物请求可能有多个响应。每个请求可能并不总是匹配。如果 MedlinePlus Connect 发现药物请求的空响应,程序将显示 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
要发送没有药物代码的文本字符串,您必须将您的查询标识为 NDC 类型的请求,以便 MedlinePlus Connect 知道您正在寻找药物信息。这仅适用于英语。您的请求可能如下所示: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 =zh
实验室测试信息请求
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=因子 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 =zh
要请求讲西班牙语的人的信息,您的请求可能类似于以下内容之一: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 数据的替代方法。