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* | Текст. |
с* | Цвет, RGB. |
fs* | Размер шрифта. |
multiple* | Многократная активация: 1 - да, 0 - нет. |
s* | Имя отправителя. |
ttl* | Срок действия уведомления (UTC). По истечении этого срока уведомление будет удалено. |
Параметры для удаления уведомления
| Параметр | Описание |
| itemId* | ID пользователя. |
| id* | ID уведомления. |
| callMode* | Тип действия. Для удаления уведомления укажите тип "delete". |
ImportantЕсли параметр ttl указывает на дату в прошлом, то уведомления срабатывают только онлайн (не хранятся на сервере). ttl — это дата в секундах от 1 января 1970 года.
Возвращаемый результат
При успешном создании уведомления возвращается следующий результат:
[
<long>, /* ID уведомления*/
{
"id":<long>, /* ID уведомления */
"t":<uint>, /* срок действия (UTC) */
"d":"<text>", /* настройка текста уведомления */
"h":"<text>", /* тема уведомления */
"s":"<text>" /* отправитель */
}
]
При успешном удалении уведомления возвращается следующий результат:
[
<long>, /* ID уведомления */
null
]
Если запрос выполнить не удалось, возвращается код ошибки.
Коды ошибок
| Код ошибки | Описание |
|---|---|
| 7 | Не удалось получить данные пользователя с ACL (ADF_ACL_ITEM_EDIT_OTHER). |
| 6 | Не удалось создать/удалить уведомление. |
| 4 | Невалидный тип действия (должно быть "create" или "delete"). |