API开放平台

TIP

# 项目任务

# 新增项目任务

接口说明： 1、通过查询对象配置 (opens new window)接口，获得对象对应的fieldList --> 字段列表结构信息 2、详细字段入参规范说明参见 附录六：aPaaS字段类型样式说明 (opens new window) 3、部分预置字段的特殊逻辑，参考 fields特殊参数说明

请求方式： POST（HTTPS）
**请求地址： ** https://openapi.qince.com/api/ig/v1/projectTaskAdd/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "fields": {
    "task_name": "任务名称",
    "project": "6928823652322085688",
    "project_stage": "6928823652322085688",
    "task_status": "1",
    "task_start_date": "2025-06-12",
    "task_end_date": "2025-06-12",
    "actual_start_date": "2025-06-12",
    "actual_end_date": "2025-06-12",
    "planned_hours": "100",
    "planned_hours_setting": "1",
    "daily_hours": "8",
    "task_members": ["5232206928823685688","3220856869288236528"],
    "fieldKey(自定义字段key)": "fieldValue(数据格式参见附录六)"
  },
  "is_trigger": false,
  "check_rule": false
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
fields VARCHAR 是 JSON格式字符串。格式：{字段key:value}，
(非特殊字段数据格式参见附录六)
slave_fields VARCHAR 是 JSON格式字符串。数据中传入id为编辑，无id为新增，
格式：{对象key:[{字段key:字段值}]}(非特殊字段数据格式参见附录六)
is_trigger boolean 否 是否触发工作流；true:触发，false:不触发
trigger_employee VARCHAR(32) 否 是否触发工作流为true的时候必填，员工id
check_rule boolean 否 是否校验验证规则和查重规则；true:校验，false:不校验

fields特殊参数说明：

字段名称 字段key 字段类型 必填 特殊说明
所属项目 project 关联项目 是 系统项目id
所属项目阶段 project_stage 关联阶段 否 系统阶段id
任务状态 task_status 单选 是 字符
计划开始日期 task_start_date 日期 是 日期格式
计划结束日期 task_end_date 日期 是 日期格式
任务成员 task_members 人员 否 人员id

响应示例：

{
  "msg_id": "X000001",
  "return_code": 0,
  "return_msg": "",
  "response_data": "6066483328179541690"
}

异常示例：

{
  "msg_id": "X000001",
  "return_code": 1,
  "return_msg": "保存失败！"
}

参数说明：

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明
return_data String

# 查询项目任务

接口说明 1、通过查询对象配置 (opens new window)接口，获得对象对应的fieldList --> 字段列表结构信息 2、请求入参操作符，详见附录操作符说明 (opens new window) 3、字段出参规范说明参见 附录六：aPaaS字段类型样式说明 (opens new window)

请求方式： POST（HTTPS）
**请求地址： ** https://openapi.qince.com/api/ig/v1/projectTaskQuery/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "page": "1",
  "rows": "100",
  "sorts": [
    {
      "field_key": "create_time",
      "type": "desc"
    }
  ],
  "query_group": [
    {
      "connector": "OR",
      "filters": [
        {
          "field_key": "task_name",
          "operator": "ISN"
        }
      ]
    },
    {
      "connector": "OR",
      "filters": [
        {
          "field_key": "field_xjcv4__c",
          "operator": "NQ",
          "field_values": [
            "1"
          ]
        }
      ]
    }
  ]
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
page INT 是 页数，默认值为1
rows INT 是 条数，默认值为100
sorts List 是 排序，默认按创建时间倒序排序
sorts.field_key VARCHAR(30) 是 排序字段
sorts.type VARCHAR(4) 是 排序类型：asc 正序，desc 倒序
query_group List 是 查询条件列表
query_group.connector List 是 组内查询条件，条件AND或OR
query_group.filters VARCHAR(4) 是 组内查询条件
query_group.filters.field_key VARCHAR(32) 是 字段key
query_group.filters.operator VARCHAR(10) 是 操作符，详见附录操作符说明 (opens new window)
query_group.filters.field_values List 是 字段值集合

响应示例：

{
  "msg_id": "X000001",
  "return_code": 0,
  "return_msg": "",
  "response_data": "<<DATA>>"
}

数据DATA示例:

[
  {
    "code": "RW2026042800028",
    "task_name": "任务01",
    "project": {
      "name": "项目01",
      "id": "8974519503550472784",
      "status": "1"
    },
    "project_stage": {
      "name": "阶段01",
      "id": "8974519503550472785",
      "status": "1"
    },
    "task_status": {
      "code": "0",
      "label": "未开始"
    },
    "task_start_date": {
      "format": "YYYY-MM-DD",
      "value": "2026-04-28"
    },
    "task_end_date": {
      "format": "YYYY-MM-DD",
      "value": "2026-04-29"
    },
    "actual_start_date": {
      "format": "YYYY-MM-DD"
    },
    "actual_end_date": {
      "format": "YYYY-MM-DD"
    },
    "planned_hours": "100.00",
    "actual_hours": "0.00",
    "execution_frequency": {
      "code": "1",
      "label": "每天"
    },
    "milestone_task": {
      "code": "false",
      "label": "否"
    },
    "planned_hours_setting": {
      "code": "1",
      "label": "按总工时"
    },
    "parent_task": {
      "name": "父任务01",
      "id": "8974519503550472786",
      "status": "1"
    },
    "daily_hours": "8.00",
    "overdue_type": {
      "code": "1",
      "label": "是"
    },
    "above_quota": {
      "code": "false",
      "label": "否"
    },
    "task_members": {
      "name": "yb",
      "id": "8495999966586348993",
      "status": "1"
    },
    "id": "8974519503550472784",
    "owner": {
      "name": "yb",
      "id": "8495999966586348993",
      "status": "1"
    },
    "department": {
      "name": "cpq1",
      "id": "10",
      "status": "1"
    },
    "lock_status": {
      "code": "UNLOCK",
      "label": "未锁定"
    },
    "create_time": {
      "format": "YYYY-MM-DD HH:mm:ss",
      "value": "2026-04-28 16:39:15"
    },
    "modify_time": {
      "format": "YYYY-MM-DD HH:mm:ss",
      "value": "2026-04-29 01:30:15"
    },
    "approval_status": {
      "code": "APPROVED",
      "label": "已通过"
    },
    "source_type": {
      "code": "LROPFXCJ",
      "label": "自建"
    },
    "creator_id": {
      "name": "XX",
      "id": "6337565123273103961",
      "status": "1"
    },
    "modifyier_id": {
      "name": "系统",
      "id": "-10000",
      "status": "1"
    },
    "status": {
      "code": "NORMAL",
      "label": "正常"
    }
  }
]

异常示例：

{
  "msg_id": "X000001",
  "return_code": 1,
  "return_msg": "查询失败！"
}

响应数据字段说明（response_data）：

字段 类型 说明
id String 任务ID
name String 任务编号
task_name String 任务名称
project Object 所属项目，包含id、name、status等
project_stage Object 所属项目阶段，包含id、name、status等
task_start_date Object 计划开始日期，包含format和value
task_end_date Object 计划结束日期，包含format和value
actual_start_date Object 实际开始日期，包含format和value
actual_end_date Object 实际结束日期，包含format和value
planned_hours String 计划工时（小时）
task_status Object 任务状态，包含code和label
execution_frequency Object 任务执行频率，包含code和label
milestone_task Object 是否里程碑任务，包含code和label
actual_hours String 实际工时（小时）
planned_hours_setting Object 计划工时配置，包含code和label
parent_task Object 父任务，包含id、name、status等
daily_hours String 每天计划工时（小时）
overdue_type Object 是否逾期，包含code和label
task_members Object 任务成员，包含id、name、status等
status Object 数据状态，包含code和label，如NORMAL-正常
lock_status Object 锁定状态，包含code和label，如UNLOCK-未锁定
approval_status Object 审批状态，包含code和label，如APPROVED-已通过
source_type Object 来源类型，包含code和label，如LROPFXCJ-自建
owner Object 负责人，包含id、name、status等
department Object 部门，包含id、name、status等
creator_id Object 创建人，包含id、name、status等
modifyier_id Object 修改人，包含id、name、status等
create_time Object 创建时间，包含format和value
modify_time Object 修改时间，包含format和value
field_xxx Any 自定义字段，字段类型和格式参见附录六

# 推送项目任务

推送说明：参见 推送aPaaS对象数据变更 (opens new window)，对应字段说明参考查询接口

请求示例：

{
  "appId": 200004,
  "data": {
    "objectKey": "ig_task",
    "code": "RW2026042800028",
    "task_name": "任务01",
    "project": {
      "name": "项目01",
      "id": "8974519503550472784",
      "status": "1"
    },
    "project_stage": {
      "name": "阶段01",
      "id": "8974519503550472785",
      "status": "1"
    },
    "task_status": {
      "code": "0",
      "label": "未开始"
    },
    "task_start_date": {
      "format": "YYYY-MM-DD",
      "value": "2026-04-28"
    },
    "task_end_date": {
      "format": "YYYY-MM-DD",
      "value": "2026-04-29"
    },
    "actual_start_date": {
      "format": "YYYY-MM-DD"
    },
    "actual_end_date": {
      "format": "YYYY-MM-DD"
    },
    "planned_hours": "100.00",
    "actual_hours": "0.00",
    "execution_frequency": {
      "code": "1",
      "label": "每天"
    },
    "milestone_task": {
      "code": "false",
      "label": "否"
    },
    "planned_hours_setting": {
      "code": "1",
      "label": "按总工时"
    },
    "parent_task": {
      "name": "父任务01",
      "id": "8974519503550472786",
      "status": "1"
    },
    "daily_hours": "8.00",
    "overdue_type": {
      "code": "1",
      "label": "是"
    },
    "above_quota": {
      "code": "false",
      "label": "否"
    },
    "task_members": {
      "name": "yb",
      "id": "8495999966586348993",
      "status": "1"
    },
    "id": "8974519503550472784",
    "owner": {
      "name": "yb",
      "id": "8495999966586348993",
      "status": "1"
    },
    "department": {
      "name": "cpq1",
      "id": "10",
      "status": "1"
    },
    "lock_status": {
      "code": "UNLOCK",
      "label": "未锁定"
    },
    "create_time": {
      "format": "YYYY-MM-DD HH:mm:ss",
      "value": "2026-04-28 16:39:15"
    },
    "modify_time": {
      "format": "YYYY-MM-DD HH:mm:ss",
      "value": "2026-04-29 01:30:15"
    },
    "approval_status": {
      "code": "APPROVED",
      "label": "已通过"
    },
    "source_type": {
      "code": "LROPFXCJ",
      "label": "自建"
    },
    "creator_id": {
      "name": "XX",
      "id": "6337565123273103961",
      "status": "1"
    },
    "modifyier_id": {
      "name": "系统",
      "id": "-10000",
      "status": "1"
    },
    "status": {
      "code": "NORMAL",
      "label": "正常"
    }
  },
  "dataFormat": "json",
  "dataId": "7203809467203730246",
  "dataSource": "biz",
  "dataType": "apaas_data_change_event",
  "tenantId": 5457613360890366827,
  "version": "v1"
}

# 删除项目任务

接口说明：

请求方式： POST（HTTPS）
**请求地址： ** https://openapi.qince.com/api/ig/v1/projectTaskDelete/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "data_id": "6928823652322085688"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
data_id VARCHAR(32) 否 任务ID

响应示例：

{
  "return_code": 0,
  "return_msg": "success",
  "msg_id": "X0001",
  "response_data": null
}

异常示例：

{
  "msg_id": "X000001",
  "return_code": 1,
  "return_msg": "数据不存在"
}

参数说明：

参数 说明
return_code 响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg 响应信息
msg_id 消息ID

# 修改项目任务

接口说明： 1、通过查询对象配置 (opens new window)接口，获得对象对应的fieldList --> 字段列表结构信息 2、详细字段入参规范说明参见 附录六：aPaaS字段类型样式说明 (opens new window)

请求方式： POST（HTTPS）
**请求地址： ** https://openapi.qince.com/api/ig/v1/projectTaskEdit/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "data_id": "6928823652322085688",
  "fields": {
    "id": "6928823652322085688",
    "task_name": "任务名称",
    "project": "6928823652322085688",
    "project_stage": "6928823652322085688",
    "task_status": "1",
    "task_start_date": "2025-06-12",
    "task_end_date": "2025-06-12",
    "actual_start_date": "2025-06-12",
    "actual_end_date": "2025-06-12",
    "planned_hours": "100",
    "execution_frequency": "1",
    "milestone_task": "0",
    "planned_hours_setting": "1",
    "daily_hours": "8",
    "task_members": ["5232206928823685688"],
    "fieldKey(自定义字段key)": "fieldValue(数据格式参见附录六)"
  },
  "slave_fields": {
    "objectKey(自定义从对象对象key)": [
      {
        "fieldKey(自定义字段key)": "fieldValue(数据格式参见附录六)"
      }
    ]
  },
  "is_trigger": false,
  "check_rule": false
}
说明： 本示例仅供参考，具体以参数说明为准。

部分参数说明：

字段 名称 类型 必填 说明
is_trigger 触发工作流 Boolean 否 是否触发工作流，默认 false
trigger_employee 触发员工 Long 否 触发员工 ID。
当 isTrigger=true 时必填
check_rule 校验规则 Boolean 否 是否校验验证规则，默认 false
data_id 数据id String 是 任务数据id
fields 任务主属性数据 Map 是 JSON格式字符串。格式：{字段key:value}，
(数据格式参见附录六)
fields.task_name 任务名称 String 否 任务名称
fields.project 所属项目ID Long 只读
fields.project_stage 所属项目阶段ID Long 否
fields.task_status 任务状态 String 否 任务状态选项对应id
fields.field_x 自定义字段 Any 只读 自定义字段，字段类型和格式参见附录六
slave_fields 从对象数据 Map 是 数据中传入id为编辑，无id为新增，
格式：{对象key:[{字段key:字段值}]}(字段数据格式参见附录六)

响应示例：

{
  "msg_id": "X000001",
  "return_code": 0,
  "return_msg": ""
}

异常示例：

{
  "msg_id": "X000001",
  "return_code": 1,
  "return_msg": "保存失败！"
}

参数说明：

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明

← mbo设置查询接口 →