生成 token(旧接口,将于 2026-05-31 下架)¶
POST /api/v1/offline_token/temporary_token/create
概述¶
生成访问 token
下架说明:
该旧接口将于 2026-05-31 下架,建议尽快改用 POST /offline_token/temporary_auth_code/create。
使用方式:
1. 页面url上添加参数: gc_route_token=xxxx; 注意如果是跨域 iframe 嵌套可能会有第三方 cookie 拦截跨域问题。
2. 如果不涉及到页面跳转。页面url上添加参数: ftAuthToken=xxx。
Body 请求参数¶
| 参数名 | 类型 | 必选 | 说明 |
|---|---|---|---|
| roles | array | 角色列表 UUID 例子: ['readOnly'] 允许为空: False |
|
| roles[*] | string | Y | 角色标识 允许为空: False |
| expires | integer | Y | toke 多久失效(单位 秒) 例子: 3600 允许为空: False $maxValue: 604800 $minValue: 1 |
参数补充说明¶
下架说明
该接口属于旧链路,将于 2026-05-31 下架。
建议改用 POST /offline_token/temporary_auth_code/create,先获取一次性 authCode,再通过前端认证兑换接口换取真实 token。
参数说明
1.支持的角色列表
| 角色 | 说明 |
|---|---|
| wsAdmin | 管理员角色 |
| general | 标准成员角色 |
| readOnly | 只读角色 |
| role_xxx | 自定义角色 UUID |