To send an on-line notice to a user, use the command user/update_user_notification:
svc=user/update_user_notification¶ms={"itemId":<long>, "id":<long>, "callMode":<text>, "h":<text>, "d":<text>, "s":<text>, "ttl":<uint>}
You can find an example of this request in the sample Executing several commands at once.
Parameters
Name | Description | |
---|---|---|
itemId | user ID | |
id | notice ID (required for deleting) | |
callMode | action: create, delete | |
Optional parameters (required for create and update) | ||
h | subject | |
d | message text | |
s | sender | |
ttl | lifetime, when expires the notice will be deleted (UTC) |
NOTE: If ttl-param points to the date in past, then notifications trigger only while online (aren’t stored on server). ttl – date in millisecs from 1 Jan 1970.
Response
On create:
[ <long>, /* notice ID */ { "id":<long>, /* notice ID */ "t":<uint>, /* lifetime (UTC) */ "d":<text>, /* message text */ "h":<text>, /* subject */ "s":<text> /* sender */ } ]
On delete:
[ <long>, /* notice ID */ null ]