update_user_notification
Чтобы отправить пользователю онлайн-уведомление, используйте метод user/update_user_notification.
Создание
svc=user/update_user_notification¶ms={
"itemId":<long>, /*обязательный*/
"callMode":"<text>", /*обязательный*/
"h":"<text>", /*обязательный*/
"d":"{ /*обязательный*/
\"body\":\"<text>\",
\"head\":{
\"c\":<uint>,
\"fs\":\"<text>\"
},
\"multiple\":<int>
}",
"s":"<text>", /*обязательный*/
"ttl":<uint> /*обязательный*/
}
Удаление
svc=user/update_user_notification¶ms={
"itemId":<long>, /*обязательный*/
"id":<long>, /*обязательный*/
"callMode":"<text>" /*обязательный*/
}
Параметры
Обязательные параметры отмечены звездочкой (*).
Параметры создания
| Название | Описание |
|---|---|
| itemId* | ID пользователя. |
| callMode* | Тип действия (для создания должен быть “create”). |
| h* | Тема. |
| d* | Настройки текста сообщения. |
| body* | Текст. |
| c* | Цвет, RGB. |
| fs* | Размер шрифта. |
| multiple* | Многократная активация: 1 — да, 0 — нет. |
| s* | Отправитель. |
| ttl* | Срок действия (UTC). По истечении срока действия уведомление будет удалено. |
Параметры удаления
| Название | Описание |
|---|---|
| itemId* | ID пользователя. |
| id* | ID уведомления. |
| callMode* | Тип действия (для удаления должен быть “delete”). |
Если параметр ttl указывает на дату в прошлом, уведомления срабатывают только онлайн (не хранятся на сервере). Параметр ttl — это дата в секундах от 1 января 1970 года (UNIX-время).
Ответ
Ответ на создание:
[
<long>, /* ID уведомления */
{
"id":<long>, /* ID уведомления */
"t":<uint>, /* срок действия (UTC) */
"d":"<text>", /* настройки текста сообщения */
"h":"<text>", /* тема */
"s":"<text>" /* отправитель */
}
]
Ответ на удаление:
[
<long>, /* ID уведомления */
null
]
Коды ошибок
| Код ошибки | Описание |
|---|---|
| 7 | Пользователь не найден, или у вас нет права доступа Редактирование неупомянутых свойств на этого пользователя. |
| 6 | Не удалось создать или удалить уведомление. |
| 4 | Неверный тип действия (должен быть “create” или “delete”), указаны неверные параметры, или настройки текста сообщения (d) превышают максимальный размер (по умолчанию 30 КБ). |