<span id="读取产品进程版本信息"></span>

# Get product process version information

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

Read version/build information reported by the current product process to record the call environment. The three logical components currently share one process build. status=ok does not establish database, Worker, or other dependency health.

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

<span id="调用前准备"></span>

## Before you call this API

Set `MOI_ENDPOINT` to the product API prefix `https://api.moi.matrixorigin.cn/v5`; use the corresponding product API URL for a dedicated deployment.

Use the target environment's product Endpoint with its actual proxy prefix. This source route requires neither product identity nor workspace. Public website example URLs do not establish actual deployment prefixes.

<span id="请求"></span>

## Request

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} Request example

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

:::::
:::::{tab-item} Parameters

No business request parameters, body, or pagination.

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

<span id="成功响应"></span>

## Successful response

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} Response example

```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} Fields

| Field | Type | Description |
| --- | --- | --- |
| code / msg | string | Both OK on success. |
| data.backend_components | array (objects) | Current three entries, not dependency health checks. |
| backend_components[].component | string | moi-backend、moi-core-catalog、mowl |
| backend_components[].version | string | Build version injected into the current process; unknown if absent. |
| backend_components[].build_time | string | Build-injected text; unknown if absent, not guaranteed parseable directly as a timestamp. |
| backend_components[].git_commit / branch_name / go_version | string | Optional DTO field; the current service also fills unknown when missing. |
| backend_components[].status | string | Currently fixed at ok, not an individual remote-component health check. |
| data.request_time | string | UTC RFC3339 time of this read. |

These fields do not return the latest SDK/CLI releases and do not replace checking installation sources.

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

<span id="错误响应"></span>

## Error responses

The current handler returns 500/ErrServer for invalid component or status enums. Service errors use shared mappings.
