跳转到主要内容
Portal token 接口返回一个短时用户 token,平台后端用它调用只读的 只读接口。如果已有 Clink 用户还没有授权过当前平台,该接口会返回浏览器授权 URL,而不是 token。

请求

新客户,或已经有有效 LoginSession 的客户,只需要 email:
已有 Clink 用户第一次授权时,需要完整的重定向和 PKCE 字段:

已授权

响应使用统一 { code, msg, data } envelope;以下示例展示完整响应。
Token claims: 调用 /agent/platform/** 时使用:

需要授权

表示 Clink 找到了已有客户,但当前平台 client 没有该客户的有效 LoginSession。让用户打开 URL,完成标准 OAuth + PKCE 回调后再次调用本接口。 授权 URL 可用时会携带 email 预填 Portal 登录页;用户仍然需要完成邮箱 OTP 验证,预填只是省去重新输入邮箱。 如果用户取消或拒绝授权,不要绕过浏览器同意流程;重新发起一次授权请求。

新用户与已有用户

Portal token 只有 access token。平台不会拿到 Portal refresh token;需要重新获取时,用平台 client token 再换一次。平台 token 始终是获取用户 token 的权限来源,只能保存在服务端。

错误

不要把平台 token 或 Portal token 放进浏览器 URL、日志或 Agent 可见输出。

下一步

使用 Portal token 调用 只读接口。