如何提升Jira API请求效率？仅同步新增及更新的工单与工作日志

一、增量提取工单（Issues） #

• 核心逻辑：利用Jira工单的updated字段，筛选出上次同步时间到当前时间范围内新增或更新的工单
• 具体实现：
  1. 在自有数据库中记录每次同步的结束时间（首次同步前可设为一个很早的时间，确保拉取全量）
  2. 调用Jira搜索API，通过JQL筛选目标数据：
     • 请求示例：GET /rest/api/3/search?jql=updated >= "2024-05-20T10:00:00+08:00"&fields=id,key,updated,summary,description
     • 说明：jql参数指定时间范围，fields参数只返回你需要的字段，减少数据传输量
  3. 处理分页：如果返回数据超过默认分页数量，循环使用startAt参数拉取所有页数据
  4. 同步完成后，将当前时间更新到数据库的同步时间记录中，作为下一次同步的起始时间

二、增量提取工作日志（Worklogs） #

• 核心逻辑：使用Jira专门的工作日志更新接口，通过since参数筛选指定时间后更新的日志
• 具体实现：
  1. 同样在数据库中记录每次同步工作日志的结束时间（毫秒级时间戳）
  2. 调用Jira工作日志更新API：
     • 请求示例：GET /rest/api/3/worklog/updated?since=1716189600000
     • 说明：since参数传入上次同步结束时间的毫秒时间戳，接口会返回该时间点之后所有新增或更新的工作日志
  3. 处理分页：接口返回的nextPageStartAt字段可用于后续分页请求，直到没有更多数据
  4. 同步完成后，更新数据库中的工作日志同步时间

三、关键注意事项 #

• 时间格式匹配：JQL的时间用ISO8601格式（如2024-05-20T10:00:00+08:00），工作日志接口用毫秒时间戳，注意时区转换
• 首次同步：第一次必须拉取全量数据，确保自有数据库的初始数据完整
• 异常回滚：如果同步过程中出现错误，不要更新同步时间，避免下次遗漏数据
• 字段精简：只请求业务需要的字段，不要拉取Jira返回的全量字段，进一步提升速度

内容的提问来源于stack exchange，提问作者Tina Izabela Timofte