请求
新客户,或已经有有效 LoginSession 的客户,只需要
email:
已授权
响应使用统一{ code, msg, data } envelope;以下示例展示完整响应。
调用
/agent/platform/** 时使用:
需要授权
email 预填 Portal 登录页;用户仍然需要完成邮箱 OTP 验证,预填只是省去重新输入邮箱。
如果用户取消或拒绝授权,不要绕过浏览器同意流程;重新发起一次授权请求。
新用户与已有用户
Portal token 只有 access token。平台不会拿到 Portal refresh token;需要重新获取时,用平台 client token 再换一次。平台 token 始终是获取用户 token 的权限来源,只能保存在服务端。
错误
不要把平台 token 或 Portal token 放进浏览器 URL、日志或 Agent 可见输出。