Teambition API

获取单个任务的计划工时总和

GET

https://open.teambition.com/api/plantime/aggregation/task/{taskId}

该接口用于根据任务 ID 查询单个任务的计划工时总和。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://open.teambition.com/api/plantime/aggregation/task/' \
--header 'Authorization: Bearer <appAccessToken>' \
--header 'X-Tenant-Id: 50c32af35a87e6b2...' \
--header 'X-Tenant-Type: organization'

响应示例

{
    "code": 200,
    "errorMessage": "string",
    "result": [
        {
            "objectId": "string",
            "objectType": "task",
            "plantime": 0,
            "count": 0,
            "objects": [
                {
                    "plantimeId": "string",
                    "objectType": "task",
                    "objectId": "string",
                    "plantime": 0,
                    "submitterId": "string"
                }
            ],
            "submitterIds": [
                "string"
            ],
            "userIds": [
                "string"
            ],
            "dates": [
                "2020-05-29T00:00:00.000Z"
            ]
        }
    ]
}

请求参数

Path 参数

taskId

string

任务 id

必需

Header 参数

Content-Type

string

可选

示例值:

application/json

Authorization

string

可选

默认值:

X-Tenant-Id

string

企业 ID

可选

默认值:

X-Tenant-Type

string

可选

默认值:

organization

返回响应

🟢200成功

application/json

Body

code

integer

是否执行成功

必需

errorMessage

string

执行结果描述

必需

result

array [object {8}]

必需

objectId

string

可选

工时关联的数据 id

objectType

string

工时关联的数据类型

可选

plantime

integer

可选

总计工时时间(单位:毫秒)

count

integer

计划工时记录数量

可选

objects

array [object {5}]

可选

submitterIds

array[string]

工时订阅者 id

可选

userIds

array[string]

用户 id

可选

dates

array[string]

日期

可选

获取单个任务的实际工时总和

获取一定时间内订阅的指定用户的实际工时聚合数