WorktileOpenAPI
  1. 任务
WorktileOpenAPI
  • 概述
  • 个人鉴权 OAuth2
    • OAuth2授权接口模拟静默授权
      • 1. 登录(公有云)
      • 1. 登录(私有部署)
      • 2. 获取 transaction_id(公有云)
      • 2. 获取 transaction_id(私有部署)
      • 3. 获取 code
      • 4. 获取 token
      • 5. 刷新 token
    • 用户接口 (SCIM)
      • 获取个人信息
      • 获取企业成员列表
      • 创建企业成员
      • 禁用企业成员
      • 更新企业成员
      • 修改企业成员属性-启用成员
      • 获取企业成员
      • 修改企业成员-启用
    • 部门接口 (SCIM)
      • 获取部门列表
      • 获取部门详情
      • 创建新部门
      • 更新部门信息
      • 更新部门属性-修改上级部门
      • 更新部门属性-修改部门名称
      • 删除部门
    • 数据导出接口
      • 获取企业数据导出任务列表
    • 任务接口(原任务模块)
      • 获取我的任务列表
      • 获取任务详情
      • 获取项目内的列表和任务
      • 创建任务
  • 团队鉴权 Tenant
    • 鉴权(token)
      • 公有云团队鉴权
        • tenant-access-token
      • 私有环境团队鉴权
        • tenant-access-token(私有部署)
    • 组织架构(contact)
      • 获取成员get members by page
      • get users by uid
      • 获取部门
    • 项目(mission)
      • 项目
        • 创建项目create project by template
        • 获取项目 get-projects-by-page
        • 获取指定项目get project by ids
        • 获取项目分组信息 get-project-groups(v9.12.0)
        • 获取项目属性信息 get-project-info(v9.32.0)
        • 修改项目基本属性 update-project-info-basic(v9.32.0)
        • 修改项目扩展属性 update-project-info-extend(v9.32.0)
        • 获取项目工时信息 get-project-workload(v9.12.0)
      • 任务
        • 标签
          • 获取标签模式 get task tag modes
          • 获取标签模式下标签 get tags by tag mode
        • 任务类型
          • 获取项目任务类型列表
          • 获取全部任务类型 get task types
          • 获取项目任务类型详情
        • 数据源(v9.23.0)
          • 获取数据源列表 get task data sources
          • 获取数据源下数据项列表 get data source items
          • 添加数据项 create item by data source
        • 创建任务
          POST
        • 获取项目中任务 get-project-tasks-by-page
          GET
        • 获取多个任务 get-tasks-by-ids
          GET
        • 获取派生任务get derived tasks
          GET
        • 获取相关任务 get-relation-tasks
          GET
        • 获取工时get workloads by task ids
          GET
        • 更改任务派生关系 update-task-derived-relation
          PUT
        • 更改任务依赖关系(前后置任务) update task dependent relation
          PUT
        • 取消任务依赖关系 remove task dependent relation
          DELETE
        • 获取项目工时 get project workloads【不再维护,推荐使用 获取工时 接口】
          GET
        • 获取工时类别 get-workload-types
          GET
        • 登记工时 create-workload
          POST
        • 获取工时
          GET
        • 获取项目任务V2(v9.0.0)
          GET
        • 获取任务流转信息 get task transitions (v9.0.0)
          GET
        • 归档任务 task archive (v9.0.0)
          PUT
        • 激活任务 task activate (v9.0.0)
          PUT
        • 获取任务详情
          GET
      • 组件
        • 看板
          • 获取看板分组 get project kanban groups
          • 获取项目看板任务 get project kanban tasks
          • 移动任务看板分组 move task kanban group
        • 概览
          • 获取所有项目概览扩展属性 getAllProjectOvewviewExProps (9.1.0)
          • 获取项目概览扩展属性 get project overview extends properties (v9.0.0)
          • 修改项目概览扩展属性(v9.1.0)
          • 获取项目概览基本属性(v9.3.3)
          • 修改项目概览基本属性(v9.3.3)
        • 迭代
          • 获取所有迭代(v9.18.0)
        • 获取项目组件 get project addons
    • 文件(file)
      • 获取文件信息
      • 获取文件流
      • upload temp file
    • 目标(goals)
      • 获取周期列表 cycles
      • 获取目标列表 objectives
      • 获取目标详情 objective detail
      • 获取目标进度 objective progress (v8.2.0)
      • 获取目标关联 objective related (v9.0.0)
    • 审批(approval)
      • 获取模板列表
      • 获取审批列表
      • 获取审批详情
  • 钩子接口 WebHook
    • 项目
      • 创建有下拉框属性的任务
      • 更新属性(update_prop) 时间类
      • 更新属性(update_prop) 负责人
      • 更新属性(update_prop) 附件类
      • 更新属性(update_prop) 下拉框
      • 更新属性(update_prop) 自定义单行文本
      • 更新属性(update_prop) 自定义多行文本 
      • 更新状态(update_state)
    • 消息
      • 简单消息
      • 复合消息
      • 自定义机器人
  • 获取TeamID
    GET
  1. 任务

获取多个任务 get-tasks-by-ids

GET
https://dev.worktile.com/open-api/mission/get-tasks-by-ids

请求参数

Query 参数
access_token
string 
必需
示例值:
{{tenant_access_token}}
fields
string 
获取字段
必需
示例值:
assignee,participant,workload,start,due,tag,shuzi,priority,desc,iteration,task_type,completed_at,update_at,attachment
task_ids
string 
必需
示例值:
{{task_id}},{{task_id}}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://dev.worktile.com/open-api/mission/get-tasks-by-ids?access_token={tenant_access_token}&fields=assignee,participant,workload,start,due,tag,shuzi,priority,desc,iteration,task_type,completed_at,update_at,attachment&task_ids={task_id},{task_id}' \
--header 'Content-Type: text/plain' \
--data-raw ''

返回响应

⚪0get-tasks-by-ids
text/plain
Body
object {0}
示例
[
    {
        "_id": "5e844c4ed1b3da63d04eec49",  //主键
        "created_by": "9d9f17dc466349d08b781da8df9dcc0a", //创建人
        "created_at": 1585728590, //创建时间
        "updated_at": 1626944856, //更新时间
        "is_archived": 0, //是否归档
        "title": "ddd", //任务标题
        "project_id": "5e844c4bd1b3da63d04eec37", //所属项目
        "properties": {
            "assignee": "9d9f17dc466349d08b781da8df9dcc0a",  //负责人
            "start": {  //开始时间
                "date": 1588262400,
                "with_time": 0  //是否包含时间
            },
            "due": { //截止时间
                "date": 1589299199,
                "with_time": 0
            },
            "workload": { // 工时
                "estimated": {},
                "reported_total": 0
            },
            "attachment": [ //附件
                "6080e0fc599e166ec3bcf77c"
            ],
            "shuzi": 333,
            "priority": "5b98e3518e18b03bd8ba5d7e", //优先级
            "tag": [],
            "participant": [  //参与人
                "138af67fdcfa4938a482b0e7b27fc113",
                "8c889567c0ca42e3951d3edc73fe2249",
                "7226d38634b94341a01d6fe8b678e3e1",
                "46f2bf2f66d74b83a64b0bf8e9da015d"
            ],
            "desc": "ddd", //任务描述
            "iteration": null //所属迭代
        },
        "state_type": 3, //任务状态类型:1 未开始,2进行中,3 完成
        "identifier": "1594", //任务编号
        "completed_at": 1610524846, //完成时间
        "derived_ids": [], //子任务主键
        "task_state": { //任务状态
            "name": "已完成",
            "type": 3, //任务状态类型:1 未开始, 2进行中, 3 完成
            "description": "任务已经完成",
            "_id": "5b98e3518e18b03bd8ba5ce0"
        },
        "task_type": { //任务类型
            "name": "任务",
            "description": "用于部门日常工作协作管理",
            "_id": "5b98e3518e18b03bd8ba5e44"
        }
    }
]
修改于 2023-08-10 03:52:37
上一页
获取项目中任务 get-project-tasks-by-page
下一页
获取派生任务get derived tasks
Built with