Table of Contents
Create/edit/delete token
This method is used for managing own tokens and user tokens to whom you have access but not for authorization (method token/login is used for that).
To create/edit/delete the token please use token/update command:
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>}
Parameters
| Name | Description |
|---|---|
| callMode | action: creation, editing, deletion (create, update, delete) |
| userId | subuser id (optional, for managing other user tokens) |
| h | token name - 72 symbols (while update, delete) |
| app | application name |
| at | token activation time, UNIX-time: 0 - now |
| dur | token duration after activation, seconds: max value = 8640000 (100 days) if 0 – duration is infinite |
| fl | access flags |
| p | custom parameters, value must be object or an array of objects “p”:“{}” is minimal |
| items | list of item ids with token granted access, optional |
| deleteAll | actual for callMode:delete; values: 1 or true - delete all created tokens |
Token is deleted automatically through 100 days of inaction ( even with dur:0)!
Object example for p-param:
"p":"{\"paramA\":\"valueB\"}"
Array of objects example for p-param:
"p":"[{\"paramA\":\"valueB\"},{\"paramB\":\"valueD\"}]"
Access flags
| Value | Description |
|---|---|
| 0x100 | online tracking |
| 0x200 | view access to most data |
| 0x400 | modification of non-sensitive data |
| 0x800 | modification of sensitive data |
| 0x1000 | modification of critical data, including messages deletion |
| 0x2000 | communication |
| -1 | unlimited operation as authorizated user (allows to manage user tokens) |
More info you can get here.
Response
{ "h":<text>, /* unique token name, 72 symbols */ "app":<text>, /* application name */ "at":<uint>, /* token activation time, UNIX-time */ "ct":<uint>, /* token creation time, UNIX-time */ "dur":<uint>, /* token duration after activation, секунды */ "fl":<uint>, /* access flags */ "items":[<long>], /* list of item ids with token granted access */ "p":<text> /* custom parameters, value must be object or an array of objects */ }
