Validate recipients
/20241001/actions/validateRecipients
Request
-
accept: string
Specifies which media types are acceptable for the response. Defaults to
application/json
.Default Value:application/json
-
accept-charset: string
Specifies which character sets are acceptable for the response. Defaults to
UTF-8
.Default Value:UTF-8
-
authorization(required): string
Contains the credentials to authenticate a consumer to the service.
-
opc-request-id: string
Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID. The only valid characters for request IDs are letters, numbers, underscore, and dash.
object
-
category(required):
string
Allowed Values:
[ "MESSAGES", "REMINDERS" ]
Type of message. Validates that the recipients are configured to recieve this message category. -
patientId:
string
Identifier of a patient. This ID is used to validate that a message recipient is in the same logical domain as the patient associated with the message.Example:
2222
-
recipients(required):
array recipients
List of recipients to be validated. This list can contain either personnel, group inboxes, or both.
array
-
Array of:
object Recipient
Recipient details.
object
-
id(required):
string
Identifier of the recipient.Example:
1111
-
recipientType(required):
string
Allowed Values:
[ "GROUPINBOX", "PERSONNEL" ]
The type of recipient.
Response
- application/json
200 Response
-
opc-request-id: string
Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
object
-
items(required):
array items
List of validated recipient details. The list may be empty and the order is not guaranteed.
array
-
Array of:
object ValidatedRecipientSummary
Information about a validated recipient.
object
-
id(required):
string
Identifier of the recipient.Example:
1111
-
isValid(required):
boolean
True indicates that the recipient is valid and able to receive notifications.
-
recipientType(required):
string
Allowed Values:
[ "GROUPINBOX", "PERSONNEL" ]
The type of recipient.
400 Response
-
opc-request-id: string
Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
object
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any errors from the resulting service call.
-
message(required):
string
A human-readable error message.
array
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
object
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
object
-
headers:
array headers
A list of the request headers which caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
/data
for a primary data object, or/data/attributes/title
for a specific attribute. A JSON pointer must point to a value in the request document that exists; if it does not, ignore the pointer.
array
array
array
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example, /data
for a primary data object, or /data/attributes/title
for a specific attribute. A JSON pointer must
point to a value in the request document that exists; if it does not, ignore the pointer.
401 Response
-
opc-request-id: string
Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
object
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any errors from the resulting service call.
-
message(required):
string
A human-readable error message.
array
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
object
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
object
-
headers:
array headers
A list of the request headers which caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
/data
for a primary data object, or/data/attributes/title
for a specific attribute. A JSON pointer must point to a value in the request document that exists; if it does not, ignore the pointer.
array
array
array
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example, /data
for a primary data object, or /data/attributes/title
for a specific attribute. A JSON pointer must
point to a value in the request document that exists; if it does not, ignore the pointer.
404 Response
-
opc-request-id: string
Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
object
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any errors from the resulting service call.
-
message(required):
string
A human-readable error message.
array
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
object
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
object
-
headers:
array headers
A list of the request headers which caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
/data
for a primary data object, or/data/attributes/title
for a specific attribute. A JSON pointer must point to a value in the request document that exists; if it does not, ignore the pointer.
array
array
array
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example, /data
for a primary data object, or /data/attributes/title
for a specific attribute. A JSON pointer must
point to a value in the request document that exists; if it does not, ignore the pointer.
422 Response
-
opc-request-id: string
Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
object
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any errors from the resulting service call.
-
message(required):
string
A human-readable error message.
array
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
object
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
object
-
headers:
array headers
A list of the request headers which caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
/data
for a primary data object, or/data/attributes/title
for a specific attribute. A JSON pointer must point to a value in the request document that exists; if it does not, ignore the pointer.
array
array
array
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example, /data
for a primary data object, or /data/attributes/title
for a specific attribute. A JSON pointer must
point to a value in the request document that exists; if it does not, ignore the pointer.
429 Response
-
opc-request-id: string
Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
object
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any errors from the resulting service call.
-
message(required):
string
A human-readable error message.
array
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
object
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
object
-
headers:
array headers
A list of the request headers which caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
/data
for a primary data object, or/data/attributes/title
for a specific attribute. A JSON pointer must point to a value in the request document that exists; if it does not, ignore the pointer.
array
array
array
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example, /data
for a primary data object, or /data/attributes/title
for a specific attribute. A JSON pointer must
point to a value in the request document that exists; if it does not, ignore the pointer.
500 Response
-
opc-request-id: string
Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
object
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any errors from the resulting service call.
-
message(required):
string
A human-readable error message.
array
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
object
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
object
-
headers:
array headers
A list of the request headers which caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
/data
for a primary data object, or/data/attributes/title
for a specific attribute. A JSON pointer must point to a value in the request document that exists; if it does not, ignore the pointer.
array
array
array
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example, /data
for a primary data object, or /data/attributes/title
for a specific attribute. A JSON pointer must
point to a value in the request document that exists; if it does not, ignore the pointer.