Объекты уведомления¶
Получить уведомление¶
-
GET/(company_code)/v2/aol/notice/(notice_uuid)¶ Прочитать уведомление
Получить данные уведомления, включая текст сообщения. Если вызвано получателем уведомления, также помечает уведомление как прочитанное.
Заголовки запроса: - Authorization –
Bearer <сессионный_токен>, либоSignature <подпись>
Параметры: - notice_uuid – Код UUID уведомления для прочтения
JSON-объект ответа: - status (string) –
successилиerror - data (object) – Объект данных уведомления. Включаемые поля зависят от роли авторизованного пользователя.
- unread_count (integer) – Количество непрочитанных уведомлений для профиля получателя
- error_code (string) – (Необязательно) Если
statusсодержитerror: один из перечисленных ниже кодов ошибки
Поля данных уведомления
Объект ответа
dataсодержит следующие поля:Имя поля Тип Описание uuid string Код UUID уведомления recipient string Мнемокод профиля получателя timestamp string Дата и время уведомления в формате ISO: YYYY-MM-DDTHH:MM:SS.mmm category string Код категории согласно таблице подстановки read_flag boolean Было ли уведомление прочитано получателем subject string Текст темы уведомления content_type string Код типа содержимого сообщения согласно таблице подстановки body string Тело сообщения уведомления Используемые коды ошибки
- auth.header.missing
- auth.header.invalid
- auth.token.invalid
- auth.token.expired
- auth.session.invalid
- auth.user.restricted
- auth.user.closed
- auth.user.denied
- object.id.notfound
- auth.restricted
- request.validation.failed
Подробнее см. Коды ошибок.
- Authorization –
Отметить уведомления как прочитанные¶
-
POST/(company_code)/v2/aol/notice/read¶ Отметить уведомления как прочитанные
Отмеченными как прочитанные могут быть только уведомления, отправленные авторизованному пользователю.
Заголовки запроса: - Authorization –
Bearer <сессионный_токен>, либоSignature <подпись>
JSON-объект запроса: - notice_uuids (array) – Коды UUID уведомлений для отметки как прочитанные
JSON-объект ответа: - status (string) –
successилиerror - data (array) – Объекты результата операции
- unread_count (integer) – Количество непрочитанных уведомлений для профиля получателя
- error_code (string) – (Необязательно) Если
statusсодержитerror: один из перечисленных ниже кодов ошибки
Поля результата операции
У каждого объекта в массиве ответа
dataесть следующие поля:Имя поля Тип Описание uuid string Код UUID уведомления из запроса status string Статус операции, successилиerrorerror_code string (Необязательно) Если statusсодержитerror: один из перечисленных ниже кодов ошибкиИспользуемые коды ошибки
- auth.header.missing
- auth.header.invalid
- auth.token.invalid
- auth.token.expired
- auth.session.invalid
- auth.user.restricted
- auth.user.closed
- auth.user.denied
- object.id.notfound
- auth.restricted
- request.validation.failed
Подробнее см. Коды ошибок.
- Authorization –