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
          POST
        • 获取项目 get-projects-by-page
          GET
        • 获取指定项目get project by ids
          GET
        • 获取项目分组信息 get-project-groups(v9.12.0)
          GET
        • 获取项目属性信息 get-project-info(v9.32.0)
          GET
        • 修改项目基本属性 update-project-info-basic(v9.32.0)
          PUT
        • 修改项目扩展属性 update-project-info-extend(v9.32.0)
          PUT
        • 获取项目工时信息 get-project-workload(v9.12.0)
          GET
      • 任务
        • 标签
          • 获取标签模式 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
        • 创建任务
        • 获取项目中任务 get-project-tasks-by-page
        • 获取多个任务 get-tasks-by-ids
        • 获取派生任务get derived tasks
        • 获取相关任务 get-relation-tasks
        • 获取工时get workloads by task ids
        • 更改任务派生关系 update-task-derived-relation
        • 更改任务依赖关系(前后置任务) update task dependent relation
        • 取消任务依赖关系 remove task dependent relation
        • 获取项目工时 get project workloads【不再维护,推荐使用 获取工时 接口】
        • 获取工时类别 get-workload-types
        • 登记工时 create-workload
        • 获取工时
        • 获取项目任务V2(v9.0.0)
        • 获取任务流转信息 get task transitions (v9.0.0)
        • 归档任务 task archive (v9.0.0)
        • 激活任务 task activate (v9.0.0)
        • 获取任务详情
      • 组件
        • 看板
          • 获取看板分组 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. 项目

创建项目create project by template

POST
https://dev.worktile.com/open-api/mission/project
{
    "template_name": "敏捷开发",  // 模板名称,必填
    "name": "用模版创建项目",  // 项目名称,必填
    "visibility": 0, //是否公开项目 0=私有,1=公开
    "members": [
        "5fd9ba644c013158dee44660"
    ] // 必须传入最少一个用户id作为团队成员,并且第一个成员默认为项目管理员
    "ext":{ // 项目概览组件中负责人,开始时间,截止时间,自定义属性的初始化
        assignee::"",
        start:,
        due:,
        properties:[{name:"",value:""}]
    }
}

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Query 参数
access_token
string 
必需
示例值:
{{tenant_access_token}}
Body 参数application/json
template_name
string 
必需
name
string 
必需
members
array[string]
可选
ext
object 
可选
start
integer 
可选
due
integer 
可选
properties
array [object {2}] 
可选
示例
{
    "template_name": "项目管理",
    "name": "OPEN API 创建公开项目 2",
    "visibility": 1,
    "members": [
        "9d9f17dc466349d08b781da8df9dcc0a"
    ],
    "ext": {
        "start": 1634709177,
        "due": 1634709177,
        "properties": [
            {
                "name": "数字属性",
                "value": 112
            },
            {
                "name": "项目名称",
                "value": "这是一个非常规范的项目名称文本"
            }
        ]
    }
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'https://dev.worktile.com/open-api/mission/project?access_token={tenant_access_token}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "template_name": "项目管理",
    "name": "OPEN API 创建公开项目 2",
    "visibility": 1,
    "members": [
        "9d9f17dc466349d08b781da8df9dcc0a"
    ],
    "ext": {
        "start": 1634709177,
        "due": 1634709177,
        "properties": [
            {
                "name": "数字属性",
                "value": 112
            },
            {
                "name": "项目名称",
                "value": "这是一个非常规范的项目名称文本"
            }
        ]
    }
}'

返回响应

🔴500create project by template
text/plain
Body
object {0}
示例
{
    "_id": "62302b9a9f170763466c6a52", //项目编号
    "name": "OPEN API 创建项目 2", //项目名称
    "members": [ //项目成员
        {
            "uid": "9d9f17dc466349d08b781da8df9dcc0a",
            "display_name": "htz",
            "name": "htz"
        }
    ],
    "visibility": "私有" //是否公开项目
}
上一页
获取部门
下一页
获取项目 get-projects-by-page
Built with