如履薄冰，步步惊心——Node.js 环境下调用 Jira REST API 的坎坷之路

2023-09-20 21:43:47

踏入 Jira REST API 的荆棘丛林

作为一名 Node.js 开发者，我迫切需要一个工具来管理公司的 Jira 项目中的任务、子任务和问题。经过一番调研，我决定使用 Jira REST API 来构建这个工具。

然而，当我满怀信心地踏入 Jira REST API 的世界时，却发现这里遍布荆棘丛林，危机四伏。从认证到权限，从问题到子任务，从分页到 JQL 搜索，每一个环节都暗藏着陷阱，让我步履维艰。

拨云见日，逐一排解

认证风波

刚开始，我信心满满地使用 Jira 提供的用户名和密码进行认证，却屡屡遭遇 "401 Unauthorized" 的错误提示。原来，Jira REST API 使用的是 OAuth 2.0 认证机制，而不是传统的用户名和密码认证。一番折腾之后，我终于搞清楚了 OAuth 2.0 的认证流程，成功获取了访问令牌。

权限旋涡

当认证成功后，我以为可以一帆风顺地获取 Jira 数据了。没想到，我又掉入了权限的旋涡。Jira REST API 对不同用户和角色设置了不同的权限级别，我需要确保自己拥有足够的权限才能访问所需的数据。经过一番研究，我找到了 Jira 的权限管理页面，并调整了自己的权限设置，终于获得了所需的数据访问权限。

问题陷阱

在获取问题数据时，我又遇到了一个坑。Jira REST API 提供了多种获取问题的方式，比如通过问题 ID、问题或 JQL 查询。一开始，我使用问题 ID 来获取问题数据，但总是得到 "404 Not Found" 的错误提示。原来，Jira REST API 的问题 ID 与 Jira 界面中显示的问题 ID 不同。我需要使用 Jira REST API 提供的获取问题 ID 的 API 来获取正确的 ID。

子任务迷宫

在获取子任务数据时，我也遇到了类似的问题。Jira REST API 提供了多种获取子任务的方式，比如通过父任务 ID、子任务 ID 或 JQL 查询。一开始，我使用子任务 ID 来获取子任务数据，但总是得到 "404 Not Found" 的错误提示。原来，Jira REST API 的子任务 ID 与 Jira 界面中显示的子任务 ID 不同。我需要使用 Jira REST API 提供的获取子任务 ID 的 API 来获取正确的 ID。