创建和管理 FHIR 资源

本页面介绍了如何创建、更新、修补、查看和删除 FHIR 资源。

FHIR 资源可以包含有关患者、设备、观察结果之类的数据。如需查看 FHIR 资源的完整列表，请参阅 FHIR 资源索引（DSTU2 或 R4）。

本页面中的 curl 和 Windows PowerShell 示例可与 R4 FHIR 存储区搭配使用，但如果您使用的是 DSTU2 或 STU3 FHIR 存储区，则我们无法保证一定有效。如果您使用的是 DSTU2 或 STU3 FHIR 存储区，请参阅 https://www.hl7.org/fhir/ 上的官方 FHIR 文档，以了解如何将示例转换为您所使用的 FHIR 版本。

Go、Java、Node.js 和 Python 示例可与 STU3 FHIR 存储区搭配使用。

创建 FHIR 资源

您必须先创建一个 FHIR 存储区，然后才能创建 FHIR 资源。

curl、Windows PowerShell 和 Python 示例展示了如何创建以下 FHIR 资源：

患者（DSTU2、STU3 和 R4）资源
患者的相遇（DSTU2、STU3 和 R4）资源
相遇的观察结果（DSTU2、STU3 和 R4）资源

所有其他语言的示例展示了如何创建通用 FHIR 资源。

如需了解详情，请参阅 projects.locations.datasets.fhirStores.fhir.create。

以下 curl 和 Windows PowerShell 示例可与 R4 FHIR 存储区搭配使用。Go、Java、Node.js 和 Python 示例可与 STU3 FHIR 存储区搭配使用。

curl

要创建“患者”资源，请发出 POST 请求并指定以下信息：

父数据集的名称
FHIR 存储区的名称
一个包含患者信息的数据 blob
资源类型
访问令牌

以下示例展示了如何使用 curl 来发送创建“患者”资源的 POST 请求：

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -H "Content-Type: application/fhir+json; charset=utf-8" \
    --data "{
      \"name\": [
        {
          \"use\": \"official\",
          \"family\": \"Smith\",
          \"given\": [
            \"Darcy\"
          ]
        }
      ],
      \"gender\": \"female\",
      \"birthDate\": \"1970-01-01\",
      \"resourceType\": \"Patient\"
    }" \
    "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient"

如果请求成功，则服务器返回 JSON 格式的类似下列示例的响应：

{
  "birthDate": "1970-01-01",
  "gender": "female",
  "id": "PATIENT_ID",
  "meta": {
    "lastUpdated": "2020-01-01T00:00:00+00:00",
    "versionId": "VERSION_ID"
  },
  "name": [
    {
      "family": "Smith",
      "given": [
        "Darcy"
      ],
      "use": "official"
    }
  ],
  "resourceType": "Patient"
}

PowerShell

要创建“患者”资源，请发出 POST 请求并指定以下信息：

父数据集的名称
FHIR 存储区的名称
一个包含患者信息的数据 blob
资源类型
访问令牌

以下示例展示了如何使用 Windows PowerShell 来发送创建“患者”资源的 POST 请求：

$cred = gcloud auth application-default print-access-token
$headers = @{ Authorization = "Bearer $cred" }

$patient = '{
  "name": [
    {
      "use": "official",
      "family": "Smith",
      "given": [
        "Darcy"
      ]
    }
  ],
  "gender": "female",
  "birthDate": "1970-01-01",
  "resourceType": "Patient"
}'

Invoke-RestMethod `
  -Method Post `
  -Headers $headers `
  -ContentType: "application/fhir+json; charset=utf-8" `
  -Body $patient `
  -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient" | ConvertTo-Json

如果请求成功，则服务器返回 JSON 格式的类似下列示例的响应：

{
  "birthDate": "1970-01-01",
  "gender": "female",
  "id": "PATIENT_ID",
  "meta": {
    "lastUpdated": "2020-01-01T00:00:00+00:00",
    "versionId": "VERSION_ID"
  },
  "name": [
    {
      "family": "Smith",
      "given": [
        "Darcy"
      ],
      "use": "official"
    }
  ],
  "resourceType": "Patient"
}

创建和管理 FHIR 资源

创建 FHIR 资源

curl

PowerShell

Go

Java

Node.js

Python

curl

PowerShell

Python

curl

PowerShell

Python

更新 FHIR 资源

curl

PowerShell

Go

Node.js

Python

有条件地更新 FHIR 资源

curl

PowerShell

Go

Python

修补 FHIR 资源

curl

PowerShell

Go

Java

Node.js

Python

有条件地修补 FHIR 资源

curl

PowerShell

Go

Python

获得 FHIR 资源

curl

PowerShell

Go

Java

Node.js

Python

获取所有患者隔离区资源

curl

PowerShell

Go

Java

Node.js

Python

获取按类型或日期过滤的患者隔离区资源

curl

PowerShell

列出 FHIR 资源版本

curl

PowerShell

Go

Java

Node.js

Python

检索 FHIR 资源版本

curl

PowerShell

Go

Node.js

Python

删除 FHIR 资源

curl

PowerShell

Go

Java

Node.js

Python

有条件地删除 FHIR 资源

curl

PowerShell

Go

Python

删除 FHIR 资源的历史版本