使用 擷取概念詳細資訊 $lookup - AWS HealthLake
使用方式支援的參數範例回應參數Behavior (行為)錯誤處理警告

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 擷取概念詳細資訊 $lookup

AWS HealthLake 現在支援 CodeSystem 資源的 $lookup操作，可讓您透過提供程式碼等識別資訊，擷取程式碼系統中特定概念的詳細資訊。當您需要執行下列動作時，此操作特別有用：

  • 擷取特定醫療代碼的詳細資訊

  • 驗證程式碼意義和屬性

  • 存取概念定義和關係

  • 使用準確的術語資料支援臨床決策

使用方式

您可以在 CodeSystem 資源上使用 GET 和 POST 方法叫用 $lookup操作：

受支援的 操作

GET [base]/CodeSystem/$lookup?system=http://snomed.info/sct&code=73211009&version=20230901
POST [base]/CodeSystem/$lookup

支援的參數

HealthLake 支援 FHIR R4 $lookup 參數的子集：

參數 類型 必要 描述
code code 是 您要查詢的概念代碼 （例如 SNOMED CT 中的 "71620000")
system uri 是 程式碼系統的正式 URL （例如 "http://snomed.info/sct")
version string 否 特定版本的程式碼系統

範例

GET 請求

GET [base]/CodeSystem/$lookup?system=http://snomed.info/sct&code=71620000&version=2023-09
POST 請求

POST [base]/CodeSystem/$lookup
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "system",
      "valueUri": "http://snomed.info/sct"
    },
    {
      "name": "code",
      "valueCode": "71620000"
    },
    {
      "name": "version",
      "valueString": "2023-09"
    }
  ]
}
回應範例

操作會傳回參數資源，其中包含概念詳細資訊：

{
    "resourceType": "Parameters",
    "parameter": [{
            "name": "name",
            "valueString": "SNOMED CT Fractures"
        },
        {
            "name": "version",
            "valueString": "2023-09"
        },
        {
            "name": "display",
            "valueString": "Fracture of femur"
        },
        {
            "name": "property",
            "part": [{
                    "name": "code",
                    "valueCode": "child"
                },
                {
                    "name": "value",
                    "valueCode": "263225007"
                },
                {
                    "name": "description",
                    "valueString": "Fracture of neck of femur"
                }
            ]
        },
        {
            "name": "property",
            "part": [{
                    "name": "code",
                    "valueCode": "child"
                },
                {
                    "name": "value",
                    "valueCode": "263227004"
                },
                {
                    "name": "description",
                    "valueString": "Fracture of shaft of femur"
                }
            ]
        }
    ]
}

回應參數

可用時，回應會包含下列參數：

參數 類型 描述
name string 程式碼系統的名稱
version string 程式碼系統的版本
display string 顯示概念的名稱
designation BackboneElement 此概念的其他表示法。
property BackboneElement 概念的其他屬性 （定義、關係等）

Behavior (行為)

$lookup 操作：

  1. 驗證所需的參數 (code 和 system)

  2. 在存放在資料存放區的指定程式碼系統中搜尋概念

  3. 傳回詳細的概念資訊，包括顯示名稱、指定項目和屬性。

  4. 提供 version 參數時支援版本特定的查詢

  5. 僅在明確存放在 HealthLake 資料存放區的程式碼系統上操作

錯誤處理

操作會處理下列錯誤條件：

  • 400 錯誤的請求：無效的$lookup操作 （不符合的請求或缺少必要的參數）

  • 找不到 404：找不到程式碼系統，或在指定的程式碼系統中找不到程式碼

警告

在此版本中，不支援下列項目：

  • $lookup 透過呼叫外部術語伺服器進行 操作

  • $lookup 由 HealthLake 管理，但未明確存放在資料存放區中的 CodeSystems 操作

如需 $lookup操作規格的詳細資訊，請參閱 FHIR R4 CodeSystem $lookup 文件。