Уведомление
Все примеры «персональных данных», представленные на данном портале, являются тестовыми (не реальными)! Примеры представлены разработчикам для тестирования ИТ-систем. Доступ к реальным данным осуществляется в соответствии с законами РФ согласно «Методическим рекомендациям». Подробнее.
Если у вас есть законные основания для подключения к Виду сведения, мы можем проконсультировать по техническим и организационным моментам подключения. Связаться с нами
Получение списка уведомлений из ГЭПС
| Атрибут | Значение |
|---|---|
| Название | search-messages |
| Наименование | Получение списка уведомления из ГЭПС |
| Тип | Адаптер для API ГЭПС сервиса |
Принимаемые параметры
| Параметр | Описание | Обязательное | Тип | Пример |
|---|---|---|---|---|
| client_uuid | Уникальный идентификатор формата UUID, сформированный соответствующим сервисом ЕСИА в привязке на сотрудника организации и ИС вендора, зарегистрированной в ЕСИА | + | Строковый | ddf21110-3548-44ec-a56a-4d954adff75a |
| status_filter | Признак прочтения. Допустимые значения: - ANY – возвращает список уведомлений без фильтрации по признаку прочтения; - READ – возвращает список уведомлений, которые были прочитаны; - UNREAD – возвращает список уведомлений, которые не были прочитаны |
+ | Строковый | ANY |
| start_date_time | Дата и время начала поиска уведомлений123 | + | Строковый | 2025-01-01T00:00:00.000+03:00 |
| end_date_time | Дата и время окончания поиска уведомлений123 | + | Строковый | 2025-01-01T00:00:00.000+03:00 |
1 - Дата и время должны быть не ранее, чем за 30 (тридцать) дней до текущей даты.
2 - Дата и время должны быть меньше чем текущая дата и время.
3 - Диапазон между датами start_date_time и end_date_time не должен превышать 1 (один) день
Параметры ответа
| Параметр | Описание | Обязательное | Тип | Пример |
|---|---|---|---|---|
| status | Статус обработки запроса. Допустимые значения: - REJECTED - запрос не прошел проверку - IN_PROGRESS - ГЭПС принял запрос/ГЭПС еще формирует список уведомлений - COMPLETED - список уведомлений получен полностью или частично - FAILED - Ошибка, дальнейшее выполнение невозможно |
+ | Строковый | COMPLETED |
| code | Код ошибки. Указывается для некоторых ошибок. | - | Строковый | VALIDATION_ERROR |
| message | Текстовое описание ошибки | - | Строковый | Ошибка доступа. Необходимо использовать данные для аутентификации от ролей «Руководитель организации» или «Администратор» |
| search_task_status | Статус запроса по данным ГЭПС. Допустимые значения: - SEARCH - в процессе сбора списка уведомлений - PROCESSING - в процессе обработки списка уведомлений - COMPLETED - список уведомлений готов - ERROR - произошла ошибка в процессе готовности списка уведомлений. В рамках задачи список не может быть подготовлен - повторите запрос на формирование списка уведомлений |
- | Строковый | COMPLETED |
| message_list | Список увемлений1 | - | Массив объектов | Последовательность элементов Message |
| total | Общее количество записей в результате поиска | - | Числовой | 3 |
| is_partial | Признак частичного результата поиска писем: - true - получено не полное количество писем - false - получены все письма |
- | Логический | false |
Ограничения и лимиты
Данный сервис имеет довольно жесткие (на момент написания) лимиты - 5 запросов в день на поиск и 15 (в день) на получение результата по сформированному в результате поиска списка. Из-за чего сервис не выполняет повторную отправку в случае возникновения ошибки.
Структура элемента Message
| Параметр | Описание | Обязательное | Тип | Пример |
|---|---|---|---|---|
| thread_uuid | Идентификатор группировки уведомлений. Одинаковый для уведомлений, которые сгруппированы по какому-то признаку, например, по УИН для уведомлений оплаты (штраф, штраф оплачен и т.п.). | + | Строковый | 6c7a5efd-2a8c-11f0-1111-808080808080 |
| message_uuid | Уникальный идентификатор уведомления. | + | Строковый | 91160bbb-f997-11ef-2222-808080808080 |
| feed_title | Наименование отправителя уведомления (такое же, как в личном кабинете организации). | + | Строковый | МВД |
| feed_subtitle | Тема уведомления (такое же, как в личном кабинете организации) | + | Строковый | Штраф оплачен |
| is_read | Признак прочтения уведомления | + | Логический | true |
| create_date | Дата создания уведомления в системе | + | Строковый | 2025-02-03T10:20:00.000+03:00 |
Примеры
Пример запроса:
{
"client_uuid": "22ee1ee3-f62b-4714-a04d-c2acdaff2a5f",
"status_filter": "ANY",
"start_date_time": "2026-02-01T00:00:00.000+03:00",
"end_date_time": "2026-02-02T00:00:00.000+03:00"
}
Пример ответа:
{
"status": "COMPLETED",
"message_list": [
{
"thread_uuid": "6c7a5efd-2a8c-11f0-1111-808080808080",
"message_uuid": "91160bbb-f997-11ef-2222-808080808080",
"feed_title": "МВД",
"feed_subtitle": "Штраф оплачен",
"is_read": true,
"create_date": "2025-02-03T10:20:00.000+03:00"
},
{
"thread_uuid": "6c7a5efd-2a8c-11f0-1111-808080808080",
"message_uuid": "91160bbb-f997-11ef-2223-808080808080",
"feed_title": "МВД",
"feed_sub_title": "Найден новый штраф",
"is_read": true,
"create_date": "2025-02-02T11:32:03.000+03:00"
},
{
"thread_uuid": "6c7a5efd-2a8c-11f0-8080-808080808080",
"message_uuid": "91160bbb-f997-11ef-8080-808080808080",
"feed_title": "ФССП",
"feed_sub_title": "Возбуждено исполнительное производство №12334/23/12333-ИП",
"is_read": true,
"create_date": "2025-01-01T00:05:01.000+03:00"
}
],
"is_partial": false,
"total": 3,
"search_task_status": "COMPLETED"
}
Пример ответа в случае ошибки:
{
"status": "FAILED",
"code": "geps",
"message": "Ошибка доступа. Необходимо использовать данные для аутентификации от ролей «Руководитель организации» или «Администратор»"
}