Generate token (Legacy API, to be deprecated on 2026-05-31)¶
POST /api/v1/offline_token/temporary_token/create
Overview¶
Generate an access token.
Deprecation Notice:
This legacy API will be deprecated on 2026-05-31. It is recommended to migrate to POST /offline_token/temporary_auth_code/create as soon as possible.
Usage:
1. Add the parameter gc_route_token=xxxx to the page url. Note: Cross-origin iframe embedding may encounter third-party cookie blocking issues.
2. If no page redirection is involved, add the parameter ftAuthToken=xxx to the page url.
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 API belongs to the legacy workflow and will be deprecated on 2026-05-31.
It is recommended to use POST /offline_token/temporary_auth_code/create instead. This new flow involves first obtaining a one-time authCode, then exchanging it for the real token via the frontend authentication exchange API.
Parameter Notes
- Supported Role List
| Role | Description |
|---|---|
| wsAdmin | Administrator role |
| general | Standard member role |
| readOnly | Read-only role |
| role_xxx | Custom role UUID |