调用 REST-Api,我想获得一个任务列表,其中包含按项目分组的相应总跟踪时间。例如,如果我有以下时间条目:
- 2h,任务1,项目A
- 1h,任务1,项目A
- 3h,任务2,项目B
- 30m,任务2,项目A
我想得到以下报告:
- 项目A
- 任务 1,3 小时
- 任务2,30m
- 项目B
- 任务 2,3 小时
目前,这可以通过 UI 实现,但我找不到通过调用 API 来做到这一点的方法。
有谁知道这是如何工作的?
不幸的是,没有端点可以返回以这种方式分组的数据,而无需在客户端进行额外的格式化。
如果您准备在客户端进行一些数据转换,您可以使用例如:
GET workspaces/{workspaceId}/reports/summary
它将包含一个“projectAndTotalTime”部分,该部分将显示每个项目的总时间条目持续时间,以及一个“timeEntries”部分,其中包含您可以在客户端按项目分组/排序的各个条目。
使用 Clockify 的新 API,这是可能的,这里是 cURL 的示例:
curl --request POST \
--url https://reports.api.clockify.me/v1/workspaces/<YOUR WORKSPACE>/reports/summary \
--header 'content-type: application/json' \
--header 'x-api-key: <YOUR API KEY>' \
--data '{
"dateRangeStart": "2020-07-13T00:00:00.000Z",
"dateRangeEnd": "2020-08-13T23:59:59.000Z",
"summaryFilter": {"groups": ["PROJECT", "TASK"]},
"exportType": "JSON"
}'
您甚至可以选择不同的导出类型,请参阅https://clockify.me/developers-api#tag-Reports。