load_last
Чтобы загрузить последние несколько сообщений за указанный период, используйте метод messages/load_last.
Конечная точка
svc=messages/load_last¶ms={"itemId":<long>,
"lastTime":<uint>,
"lastCount":<uint>,
"flags":<uint>,
"flagsMask":<uint>,
"loadCount":<uint>}
Параметры
Обязательные параметры отмечены звездочкой (*).
| Параметр | Описание |
|---|---|
itemId* |
ID объекта или ресурса (зависит от типа сообщений, которые необходимо получить). |
lastTime* |
Время, за которое запрашиваются сообщения. |
lastCount* |
Количество сообщений, которые необходимо загрузить. |
flags* |
Флаги сообщений. Загружаются только те сообщения, которые соответствуют указанным флагам. См. Сообщения. |
flagsMask* |
Маска. См. load_interval. |
loadCount* |
Количество сообщений, которое необходимо возвратить. |
Чтобы загрузить сообщения журнала объекта (флаг 0x1000), пользователю необходимо право доступа Управление журналом к объекту. Без этого права сообщения журнала не возвращаются, при этом ошибки не возникает.
Ответ
Если запрос выполнен успешно, возвращается следующий результат:
{
"count":<uint>, /* количество сообщений */
"messages":[ /* массив сообщений */
{
...
}
]
}
Форматы сообщений описаны на странице Сообщения.
При неудачном выполнении возвращается код ошибки.
Коды ошибок
| Код ошибки | Описание |
|---|---|
| 4 | Неверные входные параметры, или значение lastCount меньше 1 или больше 10 000. |
| 6 | Не удалось извлечь сообщения объекта. |
| 7 | Объект не существует, или у пользователя нет права доступа Запрос сообщений и отчетов к нему. |