# 查询账户偏好

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

读取当前认证账号的界面语言、时区和最近更新时间。响应携带 `Cache-Control: no-store`，不会修改账号设置。

```text
GET https://api.moi.matrixorigin.cn/v5/auth/preferences
```

## 调用前准备

准备用于当前账号认证的个人访问令牌或服务账号访问令牌，凭据说明见[访问凭据](../../../../../guides/billing/credentials.md#choose-credential-type)。本接口直接读取当前账号偏好，不需要提供工作区 ID。

## 请求示例

将 `$AI_STUDIO_API_KEY` 替换为实际凭据。请求可通过 `X-API-Key`、`Authorization: Bearer` 或浏览器登录会话完成认证；同一请求只能携带一种凭据，且不需要传入 `X-Workspace-ID`。

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

```bash
curl "https://api.moi.matrixorigin.cn/v5/auth/preferences" \
  -H "X-API-Key: $AI_STUDIO_API_KEY"
```

:::::
:::::{tab-item} 参数说明

本接口无路径参数、查询参数或请求体参数，直接根据当前请求的认证身份返回对应账号的偏好设置。

:::::
::::::
:::::::

## 成功响应

成功时返回 HTTP `200`，响应头包含 `Cache-Control: no-store`。顶层响应对象仅包含 `code` 和 `data`，不返回 `msg` 字段。如需修改偏好设置，可调用[更新账户偏好](update-account-preferences.md)。

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

```json
{
  "code": "OK",
  "data": {
    "locale": "zh-CN",
    "timezone": "Asia/Shanghai",
    "updated_at": "2026-10-14T08:00:00Z"
  }
}
```

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

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 请求处理成功时固定为 `OK`。 |
| `data` | object | 当前账号的偏好设置。 |
| `data.locale` | string | 账号界面语言标识，取值为 `zh-CN`、`en-US`、`fr-FR`、`es-ES`、`ar` 或 `id-ID`。 |
| `data.timezone` | string | 账号时区，使用 IANA 时区名称（例如 `Asia/Shanghai` 或 `UTC`）。 |
| `data.updated_at` | string | 偏好最近更新时间，采用 RFC 3339 格式。 |

:::::
::::::
:::::::

## 错误响应

凭据缺失或无效时返回 HTTP `401`（`Unauthorized` 或 `unauthenticated`）；同一请求混用多种认证凭据时返回 HTTP `400`（`ErrMultipleAuthCredentials`）；上游账户偏好服务不可用时返回 HTTP `502`（`ErrServiceUnavailable`）。错误响应仅包含 `code` 和 `msg`，不返回 `data` 字段。

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

```json
{
  "code": "Unauthorized",
  "msg": "Unauthorized"
}
```

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

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 错误代码，例如 `Unauthorized`、`unauthenticated`、`ErrMultipleAuthCredentials` 或 `ErrServiceUnavailable`。 |
| `msg` | string | 错误说明文本。 |

:::::
::::::
:::::::
