Active Collab API时间登记记录的修改时间戳获取及筛选问询

针对你使用Active Collab API导入时间登记记录的需求，以下是相关问题的明确解答：

1. 获取最后修改时间戳 #

Active Collab的时间登记记录（Time Record）实体原生包含updated_on字段，该字段以ISO 8601格式返回记录的最后修改时间戳。

• 你当前调用的/api/v1/reports/run?type=TrackingFilter报告接口，默认返回的报告数据可能不包含该字段。若需要获取，建议改用直接查询时间记录的接口：
  • 项目级时间记录接口：/api/v1/projects/{PROJECT_ID}/time-records
  • 全局时间记录接口：/api/v1/time-records
    这两个接口返回的单条时间记录对象中，会直接包含updated_on字段。

2. 基于修改时间字段的排序与筛选 #

直接使用时间记录列表接口时，支持通过查询参数实现排序和筛选：

• 筛选：添加filter参数指定修改时间范围，示例：

  /api/v1/time-records?filter[updated_on][from]=2023-11-25&filter[updated_on][to]=2024-01-04&project_filter=active
  

• 排序：通过sort_by和sort_order参数控制排序规则，示例：

  /api/v1/time-records?sort_by=updated_on&sort_order=desc
  

  其中sort_order可选asc（升序）或desc（降序）。

如果坚持使用TrackingFilter报告接口，可查阅Active Collab官方API文档，确认是否支持通过自定义报告配置添加updated_on字段，以及是否支持基于该字段的筛选排序规则。

内容的提问来源于stack exchange，提问作者Loïc