Actualizar practicante
Crear, sustituir o restaurar un recurso de FHIR Practitioner mediante un ID lógico.
Creación y restauración de PUT
Una PUT a un ID no utilizado crea esa identidad; una PUT a un recurso suprimido lógicamente la restaura. Ambos devuelven 201 Created y necesitan permiso de creación y actualización. La actualización de un recurso activo devuelve 200 OK y necesita permiso de actualización. Para obtener información sobre la sintaxis, las cabeceras, las condiciones previas de la versión, el comportamiento del lote y la disponibilidad del ID, consulte Create, Update, and Restore Resources with PUT.
Punto final
PUT /api/fhir/r6-ballot4/Practitioner/{rid}
URL base: https://<ddfs-instance-id>.ddfs.<region>.oci.oraclecloud.com/api/fhir/r6-ballot4
Ejemplo de solicitud: PUT /api/fhir/r6-ballot4/Practitioner/00000000-0000-4000-8000-000000000002
URL de ejemplo: https://<ddfs-instance-id>.ddfs.<region>.oci.oraclecloud.com/api/fhir/r6-ballot4/Practitioner/00000000-0000-4000-8000-000000000002
Los ejemplos utilizan identificadores y valores ilustrativos.
Cabeceras
{"Accept":"application/fhir+json","Authorization":"Bearer [REDACTED]","Content-Type":"application/fhir+json"}
Parámetros
| Parámetro | Entrante | Necesario | Tipo | Descripción |
|---|---|---|---|---|
rid |
ruta de acceso | verdadero | Cadena de ID lógico de FHIR | ID lógico del recurso Practitioner. Utilice el ID lógico del recurso. |
Condiciones previas de la versión
También puede enviar ETag desde la última lectura como If-Match, por ejemplo If-Match: W/"4". Una condición que no coincide devuelve 412 Precondition Failed sin aplicar la PUT; las cabeceras con formato incorrecto devuelven 400. Omitir la cabecera no protege frente a cambios simultáneos. Una condición proporcionada no puede crear un ID no utilizado. Consulte Actualización con If-Match.
Autorización
El modelo de autorización soportado utiliza ámbitos de OAuth 2.0 emitidos por los dominios de identidad de OCI. Envíe el token de acceso como un token de portador. Las definiciones de servidor de recursos y las reclamaciones de token de acceso emitidas utilizan ámbitos canónicos system/.... Los permisos de cliente y las solicitudes de token utilizan el formulario ddfssystem/... correspondiente. Para ver ejemplos, consulte Reference: Authentication and Scopes.
| Contexto | Forma de ámbito |
|---|---|
| Definición de servidor de recursos | system/Practitioner.u para una actualización activa; system/Practitioner.cu para la creación o restauración. |
| Solicitud de otorgamiento/token de cliente | ddfssystem/Practitioner.u para una actualización activa; ddfssystem/Practitioner.cu para la creación o restauración. |
Reclamación scope del token emitido |
system/Practitioner.u para una actualización activa; system/Practitioner.cu para la creación o restauración. |
Ejemplo de solicitud
{"resourceType":"Practitioner","identifier":[{"system":"https://example.com/fhir/identifier/Practitioner","value":"example-resource"}],"active":true,"name":[{"family":"Example","given":["Practitioner"]}],"meta":{"tag":[{"system":"https://example.com/fhir/tag","code":"example-resource","display":"Example resource"},{"system":"https://example.com/fhir/tag/phase","code":"updated","display":"Example update"}]},"address":[{"city":"Austin","state":"TX","postalCode":"78701"}],"id":"00000000-0000-4000-8000-000000000002"}
Ejemplo de respuesta
{
"resourceType": "Practitioner",
"id": "00000000-0000-4000-8000-000000000002",
"meta": {
"versionId": "2",
"lastUpdated": "2025-01-01T00:00:00Z",
"profile": [],
"security": [],
"tag": [
{
"system": "https://example.com/fhir/tag",
"code": "example-resource",
"display": "Example resource"
},
{
"system": "https://example.com/fhir/tag/phase",
"code": "updated",
"display": "Example update"
}
]
},
"identifier": [
{
"system": "https://example.com/fhir/identifier/Practitioner",
"value": "example-resource"
}
],
"active": true,
"name": [
{
"family": "Example",
"given": [
"Practitioner"
],
"prefix": [],
"suffix": []
}
],
"telecom": [],
"address": [
{
"line": [],
"city": "Austin",
"state": "TX",
"postalCode": "78701"
}
],
"photo": [],
"qualification": [],
"communication": []
}
Comportamiento
Crea un practicante con un ID lógico no utilizado, sustituye un recurso activo existente o restaura un recurso suprimido lógicamente. El tipo de recurso de cuerpo y el ID deben coincidir con la ruta de solicitud. La creación y la restauración devuelven 201; la sustitución en directo devuelve 200. Consulte Creación y restauración de PUT para conocer las cabeceras de respuesta y el comportamiento del historial.
Ejemplo de cURL
curl.exe `
-sS `
-X PUT `
https://<ddfs-instance-id>.ddfs.<region>.oci.oraclecloud.com/api/fhir/r6-ballot4/Practitioner/00000000-0000-4000-8000-000000000002 `
-H 'Accept: application/fhir+json' `
-H 'Authorization: Bearer [REDACTED]' `
-H 'Content-Type: application/fhir+json' `
--data '{"resourceType":"Practitioner","identifier":[{"system":"https://example.com/fhir/identifier/Practitioner","value":"example-resource"}],"active":true,"name":[{"family":"Example","given":["Practitioner"]}],"meta":{"tag":[{"system":"https://example.com/fhir/tag","code":"example-resource","display":"Example resource"},{"system":"https://example.com/fhir/tag/phase","code":"updated","display":"Example update"}]},"address":[{"city":"Austin","state":"TX","postalCode":"78701"}],"id":"00000000-0000-4000-8000-000000000002"}'
Códigos de Estado
| Código | Estado |
|---|---|
| 200 | Se actualizó el recurso activo. |
| 201 | Se ha creado o restaurado el recurso. |
Definición de FHIR
Canónico: https://hl7.org/fhir/6.0.0-ballot4/practitioner.html