Actualizar solicitud de servicio

Crear, sustituir o restaurar un recurso ServiceRequest de FHIR 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/r4/ServiceRequest/{rid}

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

Ejemplo de solicitud: PUT /api/fhir/r4/ServiceRequest/00000000-0000-4000-8000-000000000015

URL de ejemplo: https://<ddfs-instance-id>.ddfs.<region>.oci.oraclecloud.com/api/fhir/r4/ServiceRequest/00000000-0000-4000-8000-000000000015

Cabeceras

{"Accept":"application/fhir+json","Authorization":"Bearer [REDACTED]","Content-Type":"application/fhir+json"}

Parámetros

ParámetroEntranteNecesarioTipoDescripción
rid ruta de acceso verdadero Cadena de ID lógico de FHIR ID lógico del recurso ServiceRequest. 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/ServiceRequest.u para una actualización activa; system/ServiceRequest.cu para la creación o restauración.
Solicitud de otorgamiento/token de cliente ddfssystem/ServiceRequest.u para una actualización activa; ddfssystem/ServiceRequest.cu para la creación o restauración.
Reclamación scope del token emitido system/ServiceRequest.u para una actualización activa; system/ServiceRequest.cu para la creación o restauración.

Ejemplo de solicitud

{"resourceType":"ServiceRequest","identifier":[{"system":"https://example.com/fhir/identifier/service-request","value":"documentation-example"}],"status":"active","intent":"order","code":{"coding":[{"system":"http://loinc.org","code":"24323-8","display":"Comprehensive metabolic panel"}]},"subject":{"reference":"Patient/00000000-0000-4000-8000-000000000010"},"authoredOn":"2020-01-01T00:00:00Z","meta":{"tag":[{"system":"https://example.com/fhir/tag","code":"documentation-example","display":"Documentation example"},{"system":"https://example.com/fhir/tag/phase","code":"updated","display":"Updated example"}]},"category":[{"coding":[{"system":"http://snomed.info/sct","code":"108252007","display":"Laboratory procedure"}]}],"encounter":{"reference":"Encounter/00000000-0000-4000-8000-000000000004"},"id":"00000000-0000-4000-8000-000000000015"}

Ejemplo de respuesta

{
  "resourceType": "ServiceRequest",
  "subject": {
    "reference": "Patient/00000000-0000-4000-8000-000000000010"
  },
  "id": "00000000-0000-4000-8000-000000000015",
  "meta": {
    "versionId": "2",
    "lastUpdated": "2020-01-01T00:00:00Z",
    "profile": [],
    "security": [],
    "tag": [
      {
        "system": "https://example.com/fhir/tag",
        "code": "documentation-example",
        "display": "Documentation example"
      },
      {
        "system": "https://example.com/fhir/tag/phase",
        "code": "updated",
        "display": "Updated example"
      }
    ]
  },
  "identifier": [
    {
      "system": "https://example.com/fhir/identifier/service-request",
      "value": "documentation-example"
    }
  ],
  "instantiatesCanonical": [],
  "instantiatesUri": [],
  "basedOn": [],
  "replaces": [],
  "status": "active",
  "intent": "order",
  "category": [
    {
      "coding": [
        {
          "system": "http://snomed.info/sct",
          "code": "108252007",
          "display": "Laboratory procedure"
        }
      ]
    }
  ],
  "code": {
    "coding": [
      {
        "system": "http://loinc.org",
        "code": "24323-8",
        "display": "Comprehensive metabolic panel"
      }
    ]
  },
  "encounter": {
    "reference": "Encounter/00000000-0000-4000-8000-000000000004"
  },
  "authoredOn": "2020-01-01T00:00:00Z",
  "note": [],
  "relevantHistory": []
}

Comportamiento

Crea un ServiceRequest en 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 `
  --connect-timeout 10 `
  --max-time 90 `
  -X PUT `
  https://<ddfs-instance-id>.ddfs.<region>.oci.oraclecloud.com/api/fhir/r4/ServiceRequest/00000000-0000-4000-8000-000000000015 `
  -H 'Accept: application/fhir+json' `
  -H 'Authorization: Bearer [REDACTED]' `
  -H 'Content-Type: application/fhir+json' `
  --data '{"resourceType":"ServiceRequest","identifier":[{"system":"https://example.com/fhir/identifier/service-request","value":"documentation-example"}],"status":"active","intent":"order","code":{"coding":[{"system":"http://loinc.org","code":"24323-8","display":"Comprehensive metabolic panel"}]},"subject":{"reference":"Patient/00000000-0000-4000-8000-000000000010"},"authoredOn":"2020-01-01T00:00:00Z","meta":{"tag":[{"system":"https://example.com/fhir/tag","code":"documentation-example","display":"Documentation example"},{"system":"https://example.com/fhir/tag/phase","code":"updated","display":"Updated example"}]},"category":[{"coding":[{"system":"http://snomed.info/sct","code":"108252007","display":"Laboratory procedure"}]}],"encounter":{"reference":"Encounter/00000000-0000-4000-8000-000000000004"},"id":"00000000-0000-4000-8000-000000000015"}'

Códigos de Estado

CódigoEstado
200Se actualizó el recurso activo.
201Se ha creado o restaurado el recurso.

Definición de FHIR

Canónico: https://hl7.org/fhir/R4/servicerequest.html

Operaciones relacionadas