Содержание

Создать/редактировать/удалить токен
- Параметры
  - Флаги доступа
- Возвращаемый результат

Создать/редактировать/удалить токен

Метод предназначен для управления своими токенами или токенами пользователей, к которым есть доступ, но не для авторизации (для этого используйте token/login).

Для создания/редактирования/удаления токена используйте команду token/update:

svc=token/update&params={"callMode":<text>,
			 "userId":<text>,
			 "h":<text>,
			 "app":<text>,
			 "at":<uint>,
			 "dur":<uint>,
			 "fl":<uint>,
			 "p":<text>,
			 "items":[<long>],
			 "deleteAll":<bool>|<text>}

Параметры

Название	Описание
callMode	действие: создание, редактирование, удаление (create, update, delete)
userId	ID дочернего пользователя (необязательный, для управления токенами другого пользователя)
h	имя токена - 72 символа (при редактировании и удалении)
app	имя приложения
at	время активации токена, UNIX-time: 0 - сейчас
dur	время жизни токена после активации, секунды: макс - 8640000(100 дней), если 0 – время жизни бесконечно
fl	флаги доступа (см. ниже)
p	произвольные параметры, значение должно быть объектом или массивом объектов с экранированными кавычками (минимум пустой объект p:{})
items	список id элементов, к которым токену разрешен доступ, если не подавать - ко всем айтемам
deleteAll	актуален для callMode:delete; значения: 1 или true - удаляет все имеющиеся токены

Токен автоматически удаляется через 100 дней бездействия (даже с dur:0)!

Пример объекта для p-параметра:

"p":"{\"paramA\":\"valueB\"}"

Пример массива объектов для p-параметра:

"p":"[{\"paramA\":\"valueB\"},{\"paramB\":\"valueD\"}]"

Флаги доступа

Значение HEX	Значение DEC	Описание
0x100	256	отслеживание онлайн
0x200	512	доступ к большей части информации
0x400	1024	редактирование нечувствительной информации
0x800	2048	редактирование чувствительной информации
0x1000	4096	редактирование критичной информации, включает возможность удалять сообщения
0x2000	8192	взаимодействие
	-1	неограниченный доступ как у авторизованного пользователя (можно управлять токенами)

Все флаги используются только в DEC формате. Для применения несколько флагов нужно указывать их сумму.

Для подробных объяснений по поводу флагов доступа перейдите сюда.

Возвращаемый результат

{
	"h":<text>,		/* уникальное имя токена, 72 символа */
	"app":<text>,		/* имя приложения */
	"at":<uint>,		/* время активации токена, UNIX-time */
	"ct":<uint>,		/* время создания токена, UNIX-time */
	"dur":<uint>,		/* время жизни токена после активации, секунды */
	"fl":<uint>,		/* флаги доступа */
	"items":[<long>],	/* список id элементов, к которым токену разрешен доступ */
	"p":<text>		/* произвольные параметры, значение -- объект или массив объектов с экранированными кавычками */
}