Capability Statement Index > Response Handling
A PCOI response will always respond with a FHIR OperationOutcome resource after processing of a Consent Override Request, regardless of success, failure, or mixed results, in addition to an HTTP status code. Please note that other HTTP error codes may also be returned by ONE Access Gateway which can be found in the ONE Access Gateway Transport Specification here.
OperationOutcome resources are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. They are provided as a direct system response, or component of one, and provide information about the outcome of the operation.
The following table lists the HTTP response status codes that may come back from a PCOI FHIR request, the type of circumstances when such a response might occur, whether an OperationOutcome may or must be present (and what it will contain) and the general sort of behavior that the client system should execute.
| Code | Circumstances | OperationOutcome? | Client Expected Behavior |
|---|---|---|---|
| 201 Created | Indicates the submitted resource was accepted. | No | Display a message to the user indicating the resource was successfully submitted. |
| 400 Bad Request | This indicates that the submitted request is invalid. For example, the URL is malformed, the query parameters are badly formatted or do not match the required data type. Typically, this indicates an error with the software design of the client system, but in cases where the client does not validate inputs (e.g. dates) before submission, it is possible that allowing the user to correct search parameters could result in a successful response. | Yes | Display the message associated with the OperationOutcome to the user and also provide information for how to contact system support for the client software. The OperationOutcome.issue.diagnostics and location should be made available as well. |
| 401 Unauthorized | Indicates the request has been made without the appropriate authorization token. This should only occur if the authorization token in use has expired - as no system should make a query without having an authorization token in place. | No | The client system should re-authenticate and re-transmit the request once a new token is received |
| 403 Forbidden | The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource, or may need an account of some sort | No | Information allowing the user to contact support for their Client system should be displayed and they should be able to cancel out of the process |
| 404 Not found | This will only be returned in the event of a specified resource does not exist. | No | Information allowing the user to contact support for their Client system should be displayed and they should be able to cancel out of the process |
| 405 Method Not Allowed | A request method is not supported for the requested resource; for example, a GET request on a form that requires data to be presented via POST, or a PUT request on a read-only resource. | No | Information allowing the user to contact support for their Client system should be displayed and they should be able to cancel out of the process |
| 415 Unsupported Media Type | The request entity has a media type which the server or resource does not support. For example, the client uploads an image as image/svg+xml, but the server requires that images use a different format. | No | Information allowing the user to contact support for their Client system should be displayed and they should be able to cancel out of the process |
| 500 Internal Server Error | Indicates that the server encountered an Internal error during the process of response message | Yes | |
| 503 Service Unavailable | Indicates that the services has been temporarily taken down (on purpose) | Yes | The OperationOutcome message should be displayed to the user indicating when they should expect to be able to successfully retry the request and be able to cancel out. There's no need to expose system support information |
| 504 Gateway Timeout | Indicates that one server did not receive a timely response from another server that it was accessing while attempting to load the web page or fill another request by the browser. | No |
For additional Response Codes, see the "Expected Behaviour" section of the respective Operation Pages:
OperationOutcome is used to provide more detailed description of success, failures, and any additional issues that occurred during processing of the consent override request.
There will be at least one OperationOutcome.issue for each provincial EHR asset in the originating PCOI request. If the consent override was successfully invoked, there will only be one OperationOutcome.issue for that provincial EHR asset, indicating success for that asset. If the consent override failed for that provincial EHR asset, there will be one OperationOutcome.issue indiciating failure for that asset, in addition to zero or more OperationOutcome.issue elements passed back that EHR asset's failed consent override.
The OperationOutcome.issue.code provides a standardized description of the issue. Systems MAY create logic based on the specific code returned
The details of the issue or warning will be found in issue.details.text. This content should always be displayed to the user
The issue.details.coding values, issue.diagnostics and issue.location are intended for diagnostic purposes and will generally only be relevant to help-desk personnel. It may be appropriate to make access to this information available only by clicking on a button rather than displaying information to the user that may be confusing
issue.location will only occur if the problem is with a submitted FHIR instance (i.e. it will not be present if the issue is for query parameters, HTTP headers, etc.) It will be expressed as an XPath regardless of whether the submitted content is XML or JSON.
Powered by SIMPLIFIER.NET