如何通过Clockify API获取已删除时间条目ID列表

Clockify公开API没有提供直接查询已删除时间条目列表的独立接口，你可以根据自身同步场景选择以下两种方案实现需求：

方案1：Webhook实时监听删除事件（推荐，无遗漏、实时性高） #

• 在Clockify工作区配置Webhook，订阅TIME_ENTRY_DELETED事件类型
• 当工作区内任意时间条目被删除时，Clockify会主动向你预设的回调地址推送事件数据，payload中直接包含被删除条目的id、所属用户ID、关联项目ID等信息，拿到ID后直接触发ERP侧对应记录的删除逻辑即可
• 配置时注意确认Webhook的生效范围覆盖所有需要同步的项目、用户，避免漏收删除事件

方案2：定期全量拉取比对（兜底方案，适合补数、无Webhook场景） #

• 按设定的同步周期，调用时间条目查询接口，拉取同步周期内所有未被删除的有效时间条目，拉取时必须处理分页逻辑，直到接口返回空结果为止，避免漏拉数据
• 将本次拉取到的所有有效时间条目ID，和ERP中已存储的同时间范围的Clockify时间条目ID做集合差集计算，差集中的ID就是已经在Clockify端被删除、需要从ERP中移除的记录
• 拉取时不要加额外的条目状态过滤参数，Clockify接口默认只会返回未删除的有效条目，已删除条目不会出现在返回结果中

注意：不要尝试通过传入特殊状态值的方式直接查询已删除条目，已删除的时间条目不会在常规查询接口中返回任何信息，不存在可直接拉取已删除条目ID列表的公开接口。

拉取指定时间范围时间条目的示例请求格式：

GET /api/v1/workspaces/{你的工作区ID}/time-entries?start={同步起始时间ISO格式}&end={同步结束时间ISO格式}&page-size=200
Header: X-Api-Key: 你的Clockify API密钥

内容的提问来源于stack exchange，提问作者jp98