# 读取首页样例语言

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

`GET /workspaces/{id}/agent-home-guide/sample-locale`，普通产品身份入口。无请求体或语言选择参数。生成的 service boundary 要求 regular 访问级别；工作区路径存在不代表免认证。


## 请求参数

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

```text
GET https://api.moi.matrixorigin.cn/v5/workspaces/{id}/agent-home-guide/sample-locale
```

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

需要当前工作区的普通产品身份，无业务请求体或语言选择参数。

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


## 成功字段

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 字段说明

返回 `writeOK` 的字符串 `code: "OK"` 封套，`data` 包含：

| 字段 | 类型 | 含义 |
| --- | --- | --- |
| `region` | string | 有效部署区域 `cn` 或 `global` |
| `language` | string | 分别为 `zh-CN` 或 `en-US` |

界面语言不改变结果，方法不更新用户偏好，也不初始化或上传样例。handler 的 GET 错误映射共用文件解析错误函数，实际 locale 实现仅读取已验证配置；不能声称该方法自身会触发所有文件缺失错误。

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

## 验证边界

源码字段及两区域 service 用例已核对。不能把本地 service 返回等同端到端 GET 已通过。
