Создать/редактировать/удалить токен
Метод предназначен для управления своими токенами или токенами пользователей, к которым есть доступ, но не для авторизации (для этого используйте 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> /* произвольные параметры, значение -- объект или массив объектов с экранированными кавычками */ }
