读取产品进程版本信息

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

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

调用前准备

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

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

请求

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

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

成功响应

{
  "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"
  }
}

字段

类型

说明

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错误交由通用错误映射。

最后更新于