POST公开接口

提交当前版本并检查更新

返回是否有更新、是否必须更新、里程碑约束与目标版本。

URL

/api/v1/public/{projectKey}/versions/check-update

鉴权方式

无需鉴权

请求参数

Path 参数

名称类型必填说明
projectKeystring项目标识

请求体

{
  "current_version": "v1.20.326-buildA",
  "current_comparable_version": "1.20.326",
  "include_preview": false
}

响应示例

200 响应

{
  "should_update": true,
  "required": true,
  "reason_codes": ["outside_optional_update_range", "milestone_guard"],
  "current_version": "v1.20.326-buildA",
  "current_comparable_version": "1.20.326",
  "latest_version": { "version": "2.0.0", "comparable_version": "2.0.0" },
  "latest_preview_version": null,
  "target_version": { "version": "1.99.0", "comparable_version": "1.99.0" },
  "milestone": {
    "current": "M1",
    "latest": "M2",
    "latest_in_current": { "version": "1.99.0", "comparable_version": "1.99.0" }
  }
}
POST

Try It Out

请求 URL 预览

/api/v1/public/{projectKey}/versions/check-update