读取产品进程版本信息¶
读取当前产品进程报告的版本和构建信息,用于记录调用环境。三个逻辑组件当前共享同一进程构建信息;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错误交由通用错误映射。