General - Get notifications

API Url

Used for loading the notification header section, with master information. For the notification body (the message itself), there's another API.

GET
http://localhost:16010/ProMarkREST/rest/General/notifications

Permissions: user

Query parameters

FieldTypeDescription
statusoptionalString

Filter on notification status (R=Read, U=Unread).

Allowed values:"R""U"

Success 200

FieldTypeDescription
responseObject

Main object containing the response data.

  dataObject

Object containing the requested data.

    notificationsObject[]

Collection of notifications.

      createdDatetime

Date and time when the notification was sent.

      idNumber

Unique identifier of the notification.

      publisherString

The notification publisher.

      readBoolean

Notification status (true=Read, false=Unread).

      subjectString

The notification subject.

      typeNumber

Type of notification (1=Alert, 2=Info, 3=Message, 4=Request approved, 5=Request rejected, 6=Warning, 7=Error).

Size range: 1-7
  messageoptionalObject

Object containing response messages.

    codeNumber

Message code.

    textString

Message text.

    typeString

Type of message.

Allowed values:"warning""info"

Success example:

HTTP/1.1 200 OK
{
"response": {
"data": {
"notifications": [
{
"id": 123456789,
"publisher": "APPROVAL",
"type": 3,
"subject": "Approved transactions",
"created": 2016-11-07T16:20:00.000",
"read": false
}
]
},
"errorCode": 0,
"errorMessage": ""
}
}

Error 4xx

FieldTypeDescription
responseObject

Main object containing the response data.

  dataObject

Object containing the requested data (empty).

  errorCodeNumber

Error code.

  errorMessageString

Error description.