查询账户偏好

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

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

调用前准备

准备用于当前账号认证的个人访问令牌或服务账号访问令牌,凭据说明见访问凭据。本接口直接读取当前账号偏好,不需要提供工作区 ID。

请求示例

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

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

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

成功响应

成功时返回 HTTP 200,响应头包含 Cache-Control: no-store。顶层响应对象仅包含 code 和 data,不返回 msg 字段。如需修改偏好设置,可调用更新账户偏好。

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

字段

类型

说明

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 字段。

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

字段

类型

说明

code

string

错误代码,例如 Unauthorized、unauthenticated、ErrMultipleAuthCredentials 或 ErrServiceUnavailable。

msg

string

错误说明文本。

最后更新于