Creación de recursos FHIR

Cree un recurso FHIR comprobando la sentencia de capacidad desplegada, enviando una solicitud POST a la URL base de API con versiones coincidente y verificando la respuesta.

La interacción de creación de FHIR asigna un ID lógico y una versión inicial a un nuevo recurso. Este procedimiento utiliza un recurso de paciente FHIR R4 como ejemplo.

Antes de empezar

Confirme que:

  • Tiene acceso a una instancia de DDFS y su URL base de la API de FHIR. Un administrador debe otorgar acceso a los recursos de servicio de DDFS que desea gestionar. Consulte Políticas de DDFS. Estas políticas de IAM otorgan acceso a los recursos del servicio DDFS; no autorizan las solicitudes protegidas de API de FHIR.
  • Ha configurado una aplicación confidencial en los dominios de identidad de OCI y ha obtenido un token de acceso de OAuth con permiso para crear el recurso. Para este ejemplo de paciente, el cliente solicita un ámbito de creación o escritura de paciente aprobado, como ddfssystem/Patient.c o ddfssystem/Patient.write. Consulte sintaxis de autenticación y ámbito.
  • El cuerpo del recurso es válido para la versión de FHIR seleccionada y cualquier perfil necesario para el flujo de trabajo.

Paso 2: Obtener su URL de API de FHIR

Utilice la URL base R4 para los recursos FHIR R4 (4.0.1) y la URL base R6 para los recursos FHIR R6 ballot4 (6.0.0-ballot4):

URL base de FHIR R4 (4.0.1):

https://<ddfs-instance-id>.ddfs.<region>.oci.oraclecloud.com/api/fhir/r4

URL base de la boleta FHIR R64 (6.0.0-ballot4):

https://<ddfs-instance-id>.ddfs.<region>.oci.oraclecloud.com/api/fhir/r6-ballot4
    1. Abra el menú de navegación, seleccione Developer Services y, a continuación, seleccione Device Data FHIR Service.
    2. Seleccione la instancia de DDFS con la que desea trabajar.
    3. En Detalles de instancia, busque el punto final de servicio FHIR.
    4. Copie la URL base de la API de R4 o la URL base de la API de R6 FHIR que necesita su flujo de trabajo.
  • Utilice el comando oci ddfs instance get para recuperar los detalles de la instancia:

    oci ddfs instance get --instance-id <instance-OCID>

    Utilice el punto final de servicio FHIR devuelto para crear la URL base R4 o R6 necesaria.

  • Ejecute la operación GetInstance para recuperar los detalles de la instancia de DDFS.

    Utilice el punto final de servicio FHIR devuelto para crear la URL base R4 o R6 necesaria.

Paso 3: Confirmar recurso y crear soporte

Llame a GET <FHIR_API_BASE_URL>/metadata. CapabilityStatement devuelto es la autoridad para la instancia de DDFS desplegada.

GET <FHIR_API_BASE_URL>/metadata
Accept: application/fhir+json

Para este ejemplo, busque la entrada rest.resource cuyo valor type es Patient, confirme que su lista interaction contiene create y confirme la compatibilidad con application/fhir+json.

$metadata = Invoke-RestMethod `
  -Method Get `
  -Uri "<FHIR_API_BASE_URL>/metadata" `
  -Headers @{ Accept = "application/fhir+json" }

$patient = $metadata.rest.resource | Where-Object { $_.type -eq "Patient" }
$patient.interaction.code -contains "create"

Para obtener más información, consulte FHIR Capability Statements.

Paso 4: Crear el cuerpo de la solicitud JSON

Guarde el siguiente recurso de paciente FHIR como create-patient.json:

{
  "resourceType": "Patient",
  "identifier": [
    {
      "system": "urn:oid:1.2.36.146.595.217.0.1",
      "value": "12345"
    }
  ],
  "name": [
    {
      "family": "Silva",
      "given": ["Ana", "Carolina"]
    }
  ],
  "gender": "female",
  "birthDate": "1992-02-10"
}

Paso 5: Enviar la solicitud

Los ejemplos definen Prefer: return=representation porque el siguiente paso inspecciona el recurso de respuesta. Envíe el recurso como application/fhir+json.

  • curl -sS -X POST \
      -H "Authorization: Bearer <access-token>" \
      -H "Accept: application/fhir+json" \
      -H "Content-Type: application/fhir+json" \
      -H "Prefer: return=representation" \
      --data @create-patient.json \
      "<FHIR_API_BASE_URL>/Patient"
  • $headers = @{
      Authorization = "Bearer <access-token>"
      Accept = "application/fhir+json"
      "Content-Type" = "application/fhir+json"
      Prefer = "return=representation"
    }
    
    Invoke-RestMethod `
      -Method Post `
      -Uri "<FHIR_API_BASE_URL>/Patient" `
      -Headers $headers `
      -InFile ".\create-patient.json"

Paso 6: Verificar la respuesta

Una creación correcta devuelve 201 Created. Debido a que la solicitud utiliza Prefer: return=representation, verifique el cuerpo de la respuesta y las cabeceras. La siguiente respuesta es un extracto; el servidor puede devolver elementos adicionales:

201 Created
Location: <FHIR_API_BASE_URL>/Patient/{rid}/_history/{vid}
ETag: W/"{vid}"
Content-Type: application/fhir+json

{
  "resourceType": "Patient",
  "id": "{rid}",
  "meta": {
    "versionId": "{vid}",
    "lastUpdated": "{timestamp}"
  },
  "identifier": [
    {
      "system": "urn:oid:1.2.36.146.595.217.0.1",
      "value": "12345"
    }
  ]
}
  • La versión Location identifica el recurso lógico creado y su nueva versión.
  • La versión débil de ETag coincide con meta.versionId.
  • El recurso de respuesta contiene los valores id, meta.versionId y meta.lastUpdated asignados.

Almacene el ID lógico para las solicitudes de lectura, actualización o supresión posteriores. No trate el ID de versión como el ID lógico.