使用Xray JIRA Cloud认证API时遭遇404错误

你遇到404的核心原因是使用了错误的API端点，JIRA Cloud并没有/api/v1/authenticate这个官方认证接口。以下是两种正确的认证方式：

1. API Token + 基本认证（适合脚本/简单集成） #

这是最直接的认证方式，步骤如下：

• 生成API Token：登录Atlassian账号，进入「账号设置」→「安全」→「API令牌」，创建新令牌
• 构造认证头：将你的Atlassian邮箱和API Token用冒号拼接（比如your-email@example.com:your-api-token），然后做Base64编码
• 请求时在头部添加：Authorization: Basic <Base64编码后的字符串>
• 示例：调用JIRA项目列表API时，请求头包含上述Authorization字段，Content-Type按需设置为application/json

2. OAuth 2.0客户端凭证流程（适合应用集成） #

如果是第三方应用或长期集成，推荐用这种方式，正确的令牌获取流程：

• 正确的令牌端点：https://auth.atlassian.com/oauth/token
• 请求配置：
  • 方法：POST
  • 请求头：Content-Type: application/x-www-form-urlencoded
  • 请求体：

    grant_type=client_credentials&client_id=<你的client_id>&client_secret=<你的client_secret>&scope=read%3Ajira-work
    

• 成功请求后会返回包含access_token的响应，后续调用JIRA API时，在头部添加Authorization: Bearer <access_token>

额外注意事项 #

• 确认你的JIRA域名格式正确：https://<your-domain>.atlassian.net，不要遗漏域名部分
• 确保API Token或OAuth应用拥有对应的JIRA访问权限（比如读取项目、修改工单等）

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