(注意：对于Redmine的一些版本，你可能需要/time_entries.xml路径的其他扩展，例如2.5版本与*.json扩展兼容https://redmine.ruby-lang.org.cn/boards/2/topics/48933?r=48934#message-48934，有时在插件中可能没有任何扩展)

时间条目¶

• 目录
• 时间条目
  • 列出时间条目
    • project_id过滤器
    • spent_on过滤器
  • 显示一个时间条目
  • 创建时间条目
  • 更新时间条目
  • 删除时间条目

列出时间条目¶

GET /time_entries.xml

返回时间条目。

参数:

• offset
• limit
• user_id
• project_id
• spent_on
• ...

project_id过滤器¶

在按项目ID过滤时，您可以使用项目数字ID或其字符串标识符，例如。

...&project_id=123

...&project_id=my-custom-project

spent_on过滤器¶

在按日期过滤时，您可以要求使用自定义语法提供最小/最大日期

/time_entries.json?project_id=338&from=2019-01-01&to=2019-01-03&limit=100 

显示一个时间条目¶

GET /time_entries/[id].xml

返回给定ID的时间条目。

创建一个时间条目¶

POST /time_entries.xml

创建一个时间条目。

参数:

• time_entry (必需)：一个包含时间条目属性的哈希，包括
  • issue_id或project_id（只需一个）：记录时间的工单ID或项目ID（两者都是整数）；请注意，项目ID只能通过API找到（例如，在/projects.json中）
  • spent_on：花费时间所在的日期（默认为当前日期）；格式为例如2020-12-24
  • hours（必需）：花费的小时数
  • activity_id：时间活动的ID。除非在Redmine中定义了默认活动，否则此参数是必需的。
  • comments：条目的简短描述（最大255个字符）
  • user_id：需要指定用户ID，以便代表其他用户发布时间

响应:

• 201 已创建：已创建时间条目
• 422 无法处理实体：由于验证失败，时间条目未创建（响应体包含错误消息）

更新时间条目¶

PUT /time_entries/[id].xml

更新给定ID的时间条目。

参数:

• time_entry (必需)：包含时间条目属性的哈希（与上面相同）

响应:

• 204 无内容：时间条目已更新
• 422 无法处理实体：由于验证失败，时间条目未更新（响应体包含错误消息）

删除时间条目¶

DELETE /time_entries/[id].xml

删除指定ID的时间条目。