# 读取产品进程版本信息

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

读取当前产品进程报告的版本和构建信息，用于记录调用环境。三个逻辑组件当前共享同一进程构建信息；status=ok不证明数据库、Worker或其他依赖健康。

```text
GET https://api.moi.matrixorigin.cn/v5/system/versions
```

## 调用前准备

`MOI_ENDPOINT` 使用产品 API 前缀 `https://api.moi.matrixorigin.cn/v5`；专有部署填写对应的产品 API 地址。

使用目标环境的产品Endpoint，包含实际代理前缀。本路由源码未要求产品身份或工作区；不要从公开网站示例地址推断实际部署前缀。

## 请求

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

```bash
curl --fail-with-body "$MOI_ENDPOINT/system/versions"
```

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

无业务请求参数、请求体或分页。

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

## 成功响应

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

```json
{
  "code": "OK",
  "msg": "OK",
  "data": {
    "backend_components": [
      {
        "component": "moi-backend",
        "version": "example-build",
        "build_time": "2026-11-12T00:00:00Z",
        "git_commit": "example-commit",
        "branch_name": "example-branch",
        "go_version": "go1.25.7",
        "status": "ok"
      },
      {
        "component": "moi-core-catalog",
        "version": "example-build",
        "build_time": "2026-11-12T00:00:00Z",
        "git_commit": "example-commit",
        "branch_name": "example-branch",
        "go_version": "go1.25.7",
        "status": "ok"
      },
      {
        "component": "mowl",
        "version": "example-build",
        "build_time": "2026-11-12T00:00:00Z",
        "git_commit": "example-commit",
        "branch_name": "example-branch",
        "go_version": "go1.25.7",
        "status": "ok"
      }
    ],
    "request_time": "2026-11-12T00:00:00Z"
  }
}
```

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

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| code / msg | string | 成功均为OK |
| data.backend_components | array（对象数组） | 当前三个条目，非依赖健康探测结果 |
| backend_components[].component | string | moi-backend、moi-core-catalog、mowl |
| backend_components[].version | string | 当前进程注入的构建版本；缺少构建值为unknown |
| backend_components[].build_time | string | 构建时注入的文本，缺少时unknown，不保证可直接按时间解析 |
| backend_components[].git_commit / branch_name / go_version | string | 可选DTO字段；当前service缺少值也填unknown |
| backend_components[].status | string | 当前固定ok，不是远程组件逐一探活 |
| data.request_time | string | UTC RFC3339的本次读取时间 |

这些字段不返回SDK/CLI最新发布版本，不能替代安装来源核对。

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

## 错误响应

当前handler拒绝非法组件或状态枚举时返回500/ErrServer；service错误交由通用错误映射。
