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.coddfssystem/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 1: Crear una instancia de DDFS
Si aún no tiene una instancia, consulte Creación de una instancia de DDFS.
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/r4URL base de la boleta FHIR R64 (6.0.0-ballot4):
https://<ddfs-instance-id>.ddfs.<region>.oci.oraclecloud.com/api/fhir/r6-ballot4
- Abra el menú de navegación, seleccione Developer Services y, a continuación, seleccione Device Data FHIR Service.
- Seleccione la instancia de DDFS con la que desea trabajar.
- En Detalles de instancia, busque el punto final de servicio FHIR.
- 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 getpara 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
Locationidentifica el recurso lógico creado y su nueva versión. - La versión débil de
ETagcoincide conmeta.versionId. - El recurso de respuesta contiene los valores
id,meta.versionIdymeta.lastUpdatedasignados.
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.