Table of Contents

Send on-line notices

To send an on-line notice to a user, use the command user/update_user_notification: 

svc=user/update_user_notification&params={"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)

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
]