Метод предназначен для управления своими токенами или токенами пользователей, к которым есть доступ, но не для авторизации (для этого используйте token/login).
Для создания/редактирования/удаления токена используйте команду token/update:
svc=token/update¶ms={"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> /* произвольные параметры, значение -- объект или массив объектов с экранированными кавычками */ }