用途:通过 Jira REST API v3 进行问题跟踪与项目管理,适用于创建、查询、更新工单,管理状态流转、评论、指派与用户查询等场景。
主要能力:获取当前用户、列出项目、查看项目详情与问题类型;使用 JQL 搜索问题;获取问题详情;创建问题(支持优先级、标签);更新问题;获取可用状态流转并执行流转;添加与获取评论;指派问题;搜索用户;删除问题。
使用方式:所有示例假设已设置 JIRA_DOMAIN、JIRA_EMAIL、JIRA_API_TOKEN。基础 URL 为 https://${JIRA_DOMAIN%.atlassian.net}.atlassian.net/rest/api/3,该写法会去除 .atlassian.net 后缀,因此 mycompany 与 mycompany.atlassian.net 均可。请求使用 curl 加 -u "$JIRA_EMAIL:$JIRA_API_TOKEN" 认证,Accept 为 application/json。创建、更新、流转、评论等请求体写入 /tmp/jira_request.json 后通过 -d @/tmp/jira_request.json 发送。
关键限制:API v3 的 description 与 comment.body 需使用 Atlassian Document Format(ADF);Jira Cloud 用户引用使用 accountId 而非用户名;修改状态前应先获取可用 transitions;大结果集需用 startAt 与 maxResults 分页;遇到 429 应实现指数退避。
排障:请求失败时可运行 zero doctor check-connector --env-name JIRA_API_TOKEN 或 zero doctor check-connector --url https://your-domain.atlassian.net/rest/api/3/myself --method GET。
其他:更新、流转、删除成功返回 204 No Content。删除问题需谨慎。资料未提供收费、价格与平台支持等额外信息。