# 读取当前浏览器会话

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

`GET /auth/me`读取产品浏览器会话，返回UC主体、产品主体和CSRF值。PAT或原生Bearer不能替代有效产品会话Cookie；此入口与普通产品身份API的认证方式分开。

## 请求与前置条件

需要当前部署使用的单个非空产品会话Cookie。当前名称或备用名称混用、重复会话/CSRF Cookie会被视为无效；其他业务Cookie不因此一概被禁止。

本GET不要求已有CSRF Cookie：没有该Cookie时，服务仍可根据有效会话派生/更新CSRF值并写回Cookie。不要把POST退出的CSRF前提套到此恢复读取。

## 成功响应

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{"code":"OK","data":{"uc_sub":"subject-example","uid":"product-principal-example","email":"example@example.test","display_name":"Example","csrf_token":"example-csrf-token"}}
```

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| 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翻译。全局请求语言校验等更早失败另见[环境与语言](cookies-environments.md)。
