Teambition API

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

POST

https://open.teambition.com/api/worktime/aggregation/datesUsers

该接口用于根据查询一定时间内订阅的指定用户的实际工时聚合数。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://open.teambition.com/api/worktime/aggregation/datesUsers' \
--header 'Authorization: Bearer <appAccessToken>' \
--header 'X-Tenant-Id: 50c32af35a87e6b2...' \
--header 'X-Tenant-Type: organization' \
--header 'Content-Type: application/json' \
--data-raw '{
  "userIds": [
    "string"
  ],
  "subscriberId": "string",
  "startDate": "string",
  "endDate": "string",
  "filter": {
    "task": {
      "isDone": true,
      "isArchived": true,
      "priority": [
        -10
      ],
      "updated": "today",
      "dueDate": "today",
      "startDate": "today",
      "projectId": "string",
      "creatorId": [
        "string"
      ],
      "executorId": [
        "string"
      ],
      "involveMembers": [
        "string"
      ],
      "scenarioId": [
        "string"
      ],
      "stageId": [
        "string"
      ],
      "taskflowstatusId": [
        "string"
      ]
    },
    "project": {
      "projectId": [
        "string"
      ],
      "isArchived": true,
      "isSuspended": true
    }
  }
}'

响应示例

{
    "code": 200,
    "errorMessage": "string",
    "result": [
        {
            "userId": "string",
            "date": "2020-09-07T00:00:00.000Z",
            "worktime": 0,
            "count": 0,
            "objects": [
                {
                    "worktimeId": "string",
                    "objectType": "task",
                    "objectId": "string",
                    "worktime": 0,
                    "submitterId": "string"
                }
            ],
            "objectIds": [
                "string"
            ],
            "submitterIds": [
                "string"
            ]
        }
    ]
}

请求参数

Header 参数

Content-Type

string

可选

示例值:

application/json

Authorization

string

可选

默认值:

X-Tenant-Id

string

企业 ID

可选

默认值:

X-Tenant-Type

string

可选

默认值:

organization

Body 参数application/json

userIds

array[string]

必需

subscriberId

string

订阅者的用户 id

必需

startDate

string

必需

endDate

string

必需

filter

object

必需

task

object

必需

project

object

必需

示例

返回响应

🟢200成功

application/json

Body

code

integer

是否执行成功

必需

errorMessage

string

执行结果描述

必需

result

array [object {7}]

必需

userId

string

用户id

可选

date

string

工时所属日期字符串

可选

worktime

integer

可选

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

count

integer

计划工时记录数量

可选

objects

array [object {5}]

工时记录信息

可选

objectIds

array[string]

可选

submitterIds

array[string]

工时订阅者 id

可选

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

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