Generate token (Legacy interface, to be deprecated on 2026-05-31)¶
POST /api/v1/offline_token/temporary_token/create
Overview¶
Generate an access token.
Deprecation Notice:
This legacy interface will be deprecated on 2026-05-31. It is recommended to switch to POST /offline_token/temporary_auth_code/create as soon as possible.
Usage:
- Add parameter to page
url:gc_route_token=xxxx. Note: Cross-domain iframe embedding may encounter third-party cookie blocking issues. - If no page redirection is involved. Add parameter to page
url:ftAuthToken=xxx.
Body Request Parameters¶
| Parameter Name | Type | Required | Description |
|---|---|---|---|
| roles | array | List of role UUIDs Example: ['readOnly'] Allow empty: False |
|
| roles[*] | string | Y | Role identifier Allow empty: False |
| expires | integer | Y | Token expiration time (in seconds) Example: 3600 Allow empty: False $maxValue: 604800 $minValue: 1 |
Parameter Supplementary Notes¶
Deprecation Notice
This interface belongs to the legacy chain and will be deprecated on 2026-05-31.
It is recommended to use POST /offline_token/temporary_auth_code/create instead, first obtain a one-time authCode, and then exchange it for the real token via the frontend authentication exchange interface.
Parameter Notes
- Supported role list
| Role | Description |
|---|---|
| wsAdmin | Administrator role |
| general | Standard member role |
| readOnly | Read-only role |
| role_xxx | Custom role UUID |