Table of Contents

Users

Depending on set flags format of response can differ.

This chapter describes flags that can be applied to users and parts of resulting JSON which they are responsible for. If you specify several flags, then parts will be united into one JSON.

User flags:

Value Description
0x00000001 base flag
0x00000002 custom properties
0x00000004 billing properties
0x00000008 custom fields
0x00000020 messages
0x00000040 GUID
0x00000080 administrative fields
0x00000100 other properties
0x00000200 notifications
0x3FFFFFFFFFFFFFFF set all possible flags to user

General properties

Flag - 0x00000001

{
	"nm":<text>,	/* user name */
	"cls":<uint>,	/* superclass ID: "user" */
	"id":<uint>,	/* user ID */
	"uacl":<uint>	/* current user access level for user*/
}

Custom properties

Flag - 0x00000002

You can store any user data you need in custom properties. Usually, such settings are user's e-mail, map position after launching etc.

{
	"prp":{
		"cfmt":<text>,		/* coordinates format: "0" - degrees and minutes, "1" - degrees */		
		"email":<text>,		/* user e-mail */
		"msc":<text>,		/* map position after launching: "0" - by default, "1" - saved */
		"poisrv":<text>,	/* render POIs on server */
		...			
	}
}

Billing

Flag - 0x00000004

{
	"crt":<uint>,	/* creator ID */
	"bact":<uint>	/* account ID */
}

Custom fields

Flag - 0x00000008

{
	"flds":{		/* custom fields */
		<text>:{		/* sequence number */
			"id":<uint>,		/* ID */
			"n":<text>,		/* name */
			"v":<text>		/* value */
		},
		...
	},
	"fldsmax":<long>		/* maximal count of custom fields (-1 - unlimited) */
}

Messages

Flag - 0x00000020

After setting this flag you can receive messages from unit.

{}

GUID

Flag - 0x00000040

{
	"gd":<text>	/* user GUID */
}

Administrative fields

Flag - 0x00000080

{
	"aflds":{	/* administrative fields */		
		<text>:{	/* sequence number */
			"id":<uint>,	/* ID */
			"n":<text>,	/* name */
			"v":<text>	/* value */
		},
		...
	},
	"afldsmax":<long>,	/* maximal count of administrative fields (-1 - unlimited) */
}

Other properties

Flag - 0x00000100

{
	"fl":<uint>,	/* user settings flags */
	"hm":<text>	/* host mask */
}

The list of user settings flags is given in the chapter Set user settings flags.

Notifications

Flag - 0x00000200

{
	"usnf":{	/* user notifications */
		<text>:{		/* sequence number */
			"id":<long>,		/* ID */
			"t":<uint>,		/* lifetime (sec) */
			"d":<text>,		/* text of notification */
			"h":<text>,		/* subject */
			"s":<text>		/* sender */
		},
		...
	}
}