JIRA

简介

Jira REST API 管理问题、项目、看板和流程——无数开发团队在用。认证是 API 令牌的 HTTP Basic（或 OAuth）——无凭据请求返回 401（已实测）。

快速开始

我是谁（替换 YOUR_DOMAIN、YOUR_EMAIL、YOUR_TOKEN）：

curl "https://YOUR_DOMAIN.atlassian.net/rest/api/2/myself" \
  -u "YOUR_EMAIL:YOUR_TOKEN"

{ "accountId": "123", "emailAddress": "john@example.com", "displayName": "John Doe" }

搜索问题：

curl "https://YOUR_DOMAIN.atlassian.net/rest/api/2/search?jql=project%3DDEV&maxResults=5" \
  -u "YOUR_EMAIL:YOUR_TOKEN"

创建问题：

curl -X POST "https://YOUR_DOMAIN.atlassian.net/rest/api/2/issue" \
  -u "YOUR_EMAIL:YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"fields": {"project": {"key": "DEV"}, "summary": "Bug", "issuetype": {"name": "Task"}}}'

认证方式

• 在 id.atlassian.com/manage-profile/security/api-tokens 创建 API 令牌。
• 用 HTTP Basic：用户名 = 邮箱，密码 = API 令牌（缺失 → 401，已实测）。
• OAuth 2.0（JWT bearer）是应用的新流程。

速率限制与注意事项

• Cloud 限流：每用户约 300 次/分钟（以文档为准）——很宽裕。
• 端点：/rest/api/2/issue、/search（JQL）、/board、/sprint、/project。
• Jira Server（自托管）与 Jira Cloud（YOUR_DOMAIN.atlassian.net）的主机路径不同。
• API 版本路径（/rest/api/2/ 或 /rest/api/3/）取决于你的实例。

常见问题

Jira API 免费吗？ API 访问随 Jira 套餐提供（有限流）。

如何获取令牌？ id.atlassian.com → API tokens → Create。

认证风格是什么？ 邮箱 + API 令牌的 HTTP Basic（无凭据 401，已实测）。