查询账户偏好¶
读取当前认证账号的界面语言、时区和最近更新时间。响应携带 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"
}
}
字段 |
类型 |
说明 |
|---|---|---|
|
string |
请求处理成功时固定为 |
|
object |
当前账号的偏好设置。 |
|
string |
账号界面语言标识,取值为 |
|
string |
账号时区,使用 IANA 时区名称(例如 |
|
string |
偏好最近更新时间,采用 RFC 3339 格式。 |
错误响应¶
凭据缺失或无效时返回 HTTP 401(Unauthorized 或 unauthenticated);同一请求混用多种认证凭据时返回 HTTP 400(ErrMultipleAuthCredentials);上游账户偏好服务不可用时返回 HTTP 502(ErrServiceUnavailable)。错误响应仅包含 code 和 msg,不返回 data 字段。
{
"code": "Unauthorized",
"msg": "Unauthorized"
}
字段 |
类型 |
说明 |
|---|---|---|
|
string |
错误代码,例如 |
|
string |
错误说明文本。 |