通过Jira Rest API创建项目遇404错误及必填字段咨询

你提供的请求JSON（存在笔误） #

{
    "ket": "DEMOCREATE",
    "name":"DEMO ",
    "projectTypeKey":"business",
    "projectTemplateKey":"com.atlassian.jira-core-project-templates:jira-core-simplified-procurement",
    "description":"Rest Demo Project",
    "leadAccountId":"",
    "url":"",
    "assigneeType":"PROJECT_LEAD",
    "avatarId":1250
}

注意：JSON里的ket是笔误，正确字段名应为key，这可能是导致请求失败的原因之一。

1. leadAccountId和url字段说明 #

• leadAccountId：必填（除非Jira系统配置允许无项目负责人），是Jira中项目负责人的唯一账号ID，不是用户名或邮箱。获取方式：在Jira用户个人资料页面的URL中提取（例如https://your-domain.atlassian.net/people/5b109f2e9729b51b54dc274d里的5b109f2e9729b51b54dc274d），或通过Jira用户搜索API查询。
• url：可选字段，用于填写项目的外部关联链接（如项目官网、文档地址），不需要可留空或直接删除该字段。

2. 创建项目/Issue的必填字段 #

创建项目的必填字段

根据Jira REST API（Cloud/Data Center）规范，创建项目必须包含以下字段：

• key：项目唯一标识（需大写字母/数字，不能与现有项目重复）
• name：项目名称
• projectTypeKey：项目类型，可选值为business（Jira Core）、software（Jira Software）、service_desk（Jira Service Management）
• projectTemplateKey：对应项目类型的模板ID，需与projectTypeKey匹配
• leadAccountId：项目负责人账号ID（系统允许无负责人时可选）

其他字段如description、assigneeType、avatarId、url均为可选。

创建Issue的必填字段

创建Issue必须包含以下字段：

• project：指定所属项目，可通过key（如DEMOCREATE）或id标识
• summary：Issue的标题
• issuetype：Issue类型，可通过name（如"任务"、"Bug"）或id标识

关于404错误的额外提示 #

除了字段笔误，还需检查：

• API端点是否正确：Jira Cloud为POST /rest/api/3/project，Data Center通常为POST /rest/api/2/project
• 调用者是否拥有创建项目的权限
• 认证信息是否有效（如API token、用户名密码是否正确）

内容的提问来源于stack exchange，提问作者Steffan Abishake