应用 (system)

应用管理，支持获取应用列表，支持获取产品下的应用、创建应用、修改应用

动作概览

SDK 动作	说明	方法	路径
list	获取应用列表，支持获取产品下的应用	GET	/products/{productID}/systems
create	创建应用	POST	/systems
update	修改应用	PUT	/systems/{systemID}

获取应用列表，支持获取产品下的应用

• SDK 调用：request("system/list", params)
• HTTP：GET /products/{productID}/systems
• 动作类型：list
• 最低禅道版本：22.0 / biz13.0 / max8.0 / ipd5.0

路径参数

参数	说明
productID	所属产品ID

查询参数

参数	类型	必填	默认值	说明
orderBy	string	否		排序 id_asc ID 升序 id_desc ID 降序 name_asc 名称 升序 name_desc 名称 降序 status_asc 状态 升序 status_desc 状态 降序
recPerPage	number	否		每页数量，不超过1000
pageID	number	否		页码，从第1页开始

请求体

无请求体。

返回值

• 返回形态：list
• 结果字段：systems
• 分页字段：pager

SDK 示例

import { request } from 'zentao-api';

const result = await request("system/list", {
  "productID": 1,
  "orderBy": "id_asc",
  "recPerPage": 1,
  "pageID": 1
});

创建应用

• SDK 调用：request("system/create", params)
• HTTP：POST /systems
• 动作类型：create
• 最低禅道版本：22.0 / biz13.0 / max8.0 / ipd5.0

路径参数

无路径参数。

查询参数

无查询参数。

请求体

请求体必填：是

Schema:

{
  "type": "object",
  "properties": {
    "productID": {
      "type": "integer",
      "description": "所属产品",
      "format": "int32"
    },
    "integrated": {
      "type": "integer",
      "description": "是否集成应用(0 否| 1 是)",
      "format": "int32"
    },
    "children": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "集成应用需要包含其他应用，非集成应用传空数组[]"
    },
    "name": {
      "type": "string",
      "description": "应用名称"
    },
    "desc": {
      "type": "string",
      "description": "描述"
    }
  },
  "required": [
    "productID",
    "integrated",
    "children",
    "name"
  ]
}

示例:

{
  "productID": 1,
  "integrated": 0,
  "children": [],
  "name": "smart-20260819093823",
  "desc": "smart-20260819093823"
}

返回值

• 返回形态：object

SDK 示例

import { request } from 'zentao-api';

const result = await request("system/create", {
  "productID": 1,
  "integrated": 1,
  "children": [
    "<string>"
  ],
  "name": "<string>",
  "desc": "<string>"
});

修改应用

• SDK 调用：request("system/update", params)
• HTTP：PUT /systems/{systemID}
• 动作类型：update
• 最低禅道版本：22.0 / biz13.0 / max8.0 / ipd5.0

路径参数

参数	说明
systemID	应用ID

查询参数

无查询参数。

请求体

请求体必填：是

Schema:

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "应用名称"
    },
    "children": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "集成应用需要包含其他应用，非集成应用传空数组[]"
    },
    "desc": {
      "type": "string",
      "description": "描述"
    }
  },
  "required": [
    "name",
    "children"
  ]
}

示例:

{
  "name": "smart-20260819093823-updated",
  "children": [],
  "desc": "smart-20260819093823-updated"
}

返回值

• 返回形态：object

SDK 示例

import { request } from 'zentao-api';

const result = await request("system/update", {
  "systemID": 1,
  "name": "<string>",
  "children": [
    "<string>"
  ],
  "desc": "<string>"
});