MedlinePlus Connect: Web アプリケーション
![Introduction to MedlinePlus](https://i.ytimg.com/vi/9uH-Wk9ZA3E/hqdefault.jpg)
コンテンツ
- Webアプリケーションの概要
- 診断要求 (問題) コード
- オプションのパラメータ
- 問題コードのリクエスト例
- 医薬品情報の請求
- オプションのパラメータ
- 医薬品コードのリクエストの例
- ラボ テスト情報のリクエスト
- オプションのパラメータ
- ラボテストのリクエスト例
- 利用規定
- 詳しくは
MedlinePlus Connect は、Web アプリケーションまたは Web サービスとして利用できます。以下に基づいてリクエストに応答する Web アプリケーションを実装するための技術的な詳細を示します。
MedlinePlus Connect を使用する場合は、メーリング リストにサインアップして、開発状況を把握し、同僚とアイデアを交換してください。 MedlinePlus Connect を実装しているかどうかについては、お問い合わせからお知らせください。 MedlinePlus Connect が提供するデータにリンクして表示することは大歓迎です。このサービス外の MedlinePlus コンテンツにリンクする方法の詳細については、リンクに関するガイドラインと手順をご覧ください。
Webアプリケーションの概要
Web アプリケーションの API は、HL7 Context-Aware Knowledge Retrieval (Infobutton) ナレッジ リクエスト 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 です。このリンクは、検索ボックスが空のページを表示します。このアプリケーションへのクエリには 2 つの必須パラメータがあります。
- 使用する問題コード システムを特定します。
- 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%20uncontrol&informationRecipient.languageCode.c=es
SNOMED CTコード41381004を使用して「シュードモナスによる肺炎」と診断された患者:https://connect.medlineplus.gov/application?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381dCriteria=肺炎%20%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 にのみ対応します。テキスト文字列は使用しません。英語での回答は可能ですが、スペイン語での回答はありません。
1 つの投薬リクエストに対して複数の応答がある場合があります。リクエストごとに常に一致するとは限りません。 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=チャンティックス 0.5 MG 経口錠剤
英語の請求の場合、少なくともコード体系とコード、またはコード体系と薬の名前を特定する必要があります。英語のリクエストに対して最良の結果を得るには、3 つすべてを送信してください。スペイン語のリクエストの場合、コード システムとコードを特定する必要があります。
オプションのパラメータ
英語情報のリクエストを送信する場合、医薬品の名前のオプション パラメータを含めることができます。これについては、上記のセクションで詳しく説明しています。このパラメータは、スペイン語のリクエストには使用されません。
リクエストを英語にするかスペイン語にするかを指定してください。指定されていない場合、MedlinePlus Connect は英語が言語であると想定します。
薬コード検索への応答をスペイン語にする場合は、次を使用します: informationRecipient.languageCode.c=es (=sp も受け入れます)
英語を指定するには、次を使用します: informationRecipient.languageCode.c=en
医薬品コードのリクエストの例
医薬品情報のリクエストは、次のいずれかの形式にする必要があります。
RXCUI によって情報を要求するには、要求は次のようになります。 =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. =en
ラボ テスト情報のリクエスト
MedlinePlus Connect は、LOINC リクエストを受信したときに、ラボ試験情報との一致を提供します。 MedlinePlus Connect は、英語またはスペイン語でのラボ テスト リクエストへの応答を提供でき、MedlinePlus ラボ テスト情報と最も一致する結果ページへのリンクを返します。
ラボ テスト情報のリクエストの場合、ベース URL は https://connect.medlineplus.gov/application です。
これらは、このアプリケーションへのラボ テスト クエリの 2 つの必須パラメーターです。
- 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.languageCodec. =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.languageCodec. =es
利用規定
MedlinePlus サーバーの過負荷を避けるために、NLM では、MedlinePlus Connect のユーザーが IP アドレスごとに 1 分あたり 100 を超えるリクエストを送信しないように要求しています。この制限を超えるリクエストは処理されず、300 秒間、またはリクエスト レートが制限を下回るまでのいずれか遅い方まで、サービスは復元されません。 Connect に送信するリクエストの数を制限するために、NLM は 12 ~ 24 時間の期間結果をキャッシュすることをお勧めします。
このポリシーは、サービスが引き続き利用可能であり、すべてのユーザーがアクセスできるようにするために設定されています。 MedlinePlus Connect に大量のリクエストを送信する必要がある特定のユース ケースがあり、そのためこのポリシーに記載されているリクエスト レート制限を超える場合は、お問い合わせください。 NLMのスタッフがあなたのリクエストを評価し、例外が認められるかどうかを判断します。 MedlinePlus XML ファイルのドキュメントも確認してください。これらの XML ファイルには、完全な健康トピック レコードが含まれており、MedlinePlus データにアクセスする代替方法として使用できます。