读取当前浏览器会话¶
GET /auth/me读取产品浏览器会话,返回UC主体、产品主体和CSRF值。PAT或原生Bearer不能替代有效产品会话Cookie;此入口与普通产品身份API的认证方式分开。
请求与前置条件¶
需要当前部署使用的单个非空产品会话Cookie。当前名称或备用名称混用、重复会话/CSRF Cookie会被视为无效;其他业务Cookie不因此一概被禁止。
本GET不要求已有CSRF Cookie:没有该Cookie时,服务仍可根据有效会话派生/更新CSRF值并写回Cookie。不要把POST退出的CSRF前提套到此恢复读取。
成功响应¶
{"code":"OK","data":{"uc_sub":"subject-example","uid":"product-principal-example","email":"example@example.test","display_name":"Example","csrf_token":"example-csrf-token"}}
字段 |
类型 |
说明 |
|---|---|---|
code |
string |
OK;当前成功封套没有msg |
data.uc_sub |
string |
UC主体,不与产品或IAM用户ID互换 |
data.uid |
string |
产品principal ID,不是Catalog/IAM用户ID |
data.email |
string |
此产品会话保存的邮箱 |
data.display_name |
string |
此产品会话保存的显示名 |
data.csrf_token |
string |
服务端为该产品会话确认的CSRF值,供受保护写请求使用 |
前端类型中的profile_updated_at、手机、姓与名等额外字段不能据此自动补进此接口响应表。
读取过程会验证本地未撤销会话并向UC验证活跃状态;inactive时撤销本地会话。上游显示资料不等于每次都完整替换本地会话的邮箱和名称快照。
错误与状态判断¶
HTTP |
code |
当前含义 |
|---|---|---|
401 |
unauthenticated |
缺少、无效、已撤销或上游不再活跃的产品会话;handler清当前部署会话/CSRF Cookie |
502 |
ErrServiceUnavailable |
UC验证依赖不可用,不应一律解释为登录过期 |
500 |
ErrServer |
数据库、映射或其他内部错误 |
普通浏览器错误封套使用code/msg,msg由HTTP状态文本生成;本页不承诺所有msg随Content-Language翻译。全局请求语言校验等更早失败另见环境与语言。