# 说明
新建花费工时，返回新建花费工时的数据
# url
https://api.tapd.cn/timesheets
# 支持格式
JSON/XML（默认JSON格式）
# HTTP请求方式
POST
# 请求数限制
一次插入一条数据。注意同一 entity_type、entity_id、spentdate、owner ，只能有一条工时记录
# 请求参数
| 字段名 | 必选 | 类型及范围 | 说明 |
|---|---|---|---|
| entity_type | 是 | string | 对象类型，如story、task、bug等 |
| entity_id | 是 | integer | 对象ID |
| timespent | 是 | string | 花费工时 |
| timeremain | 否 | string | 剩余工时 |
| spentdate | 否 | date | 花费日期 |
| owner | 是 | string | 花费创建人 |
| workspace_id | 是 | integer | 项目ID |
| memo | 否 | string | 花费描述 |
# 调用示例及返回结果
# 在需求 1010158231500709717 下新建一条 2020-05-05，花费为 2 ，花费人是 anyechen 的工时记录
# curl 使用 Basic Auth 鉴权调用示例
curl -u 'api_user:api_password' -d 'entity_type=story&entity_id=1010158231500709717&owner=anyechen×pent=2&spentdate=2020-05-05&workspace_id=10158231' 'https://api.tapd.cn/timesheets'
# 返回结果
{
"status": 1,
"data": {
"Timesheet": {
"id": "1010158231001169003",
"entity_type": "story",
"entity_id": "1010158231500709717",
"timespent": "2",
"spentdate": "2020-05-05",
"owner": "anyechen",
"created": "2020-05-06 22:08:35",
"workspace_id": "10158231",
"memo": null
}
},
"info": "success"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# 花费工时字段说明
# 花费工时重要字段说明
| 字段 | 说明 |
|---|---|
| id | id |
| entity_type | 对象类型，如story、task、bug等 |
| entity_id | 对象ID |
| timespent | 花费工时 |
| timeremain | 剩余工时 |
| spentdate | 花费日期 |
| owner | 花费创建人 |
| created | 创建时间 |
| workspace_id | 项目ID |
| memo | 花费描述 |