Deny Authorization
Authorization is in pended status can be brought back in the "Change" status by the unfinalize operation.
When an authorization is the status "Pended", a Deny link is added to the authorization resource:
... authorization properties ...
"links": [
{
"href": "http://<host>:<port>/api/generic/authorizations/<id>",
"rel": "self"
},
{
"href": "http://<host>:<port>/api/authorizations/<authorization id>/unfinalize",
"rel": "authorization:deny",
"httpMethod": "POST"
}
]
}
Clients must send one authorization Fatal message in the POST payload:
{
"authorizationmessage": [
{
"sourceReference": "<source reference value>",
"message": {
"id": "<id of message>"
}
}
In the example, Famtal message is passed. Without a fatal message, HTTP Status 400 (Bad Request) is returned
Authorization
The operation in this section is protected by access restriction "authorization.deny IP". A grant must be given with both the Read and Update flag set. A Read grant must also be given to access restriction "authorizations API".
Response Message
- Success
-
HTTP 303 SEE OTHER after the operation is completed successfully, request is redirected to authorizations API.
- Failure
| Response | Description |
|---|---|
HTTP 401 |
Unauthorized |
HTTP 404 |
Authorization form code {code} is unknown |
HTTP 409 |
Authorization is not in a status that allows Deny |
Please refer to the 'Response Messages' section in the HTTP API Integration Points part of the Common Features book for more details.