更新时间:2022-12-08 GMT+08:00

创建项目

功能介绍

创建项目

URI

POST /v4/project

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

最小长度:10

最大长度:32768

表2 请求Body参数

参数

是否必选

参数类型

描述

project_name

String

项目名称

最小长度:1

最大长度:128

description

String

项目描述

source

String

项目来源

project_type

String

项目类型 scrum, xboard(看板项目), basic, phoenix(凤凰项目)

enterprise_id

String

项目要绑定的企业项目ID

template_id

Integer

用户创建的项目模板id

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

project_num_id

Integer

项目数字id

project_id

String

项目id

最小长度:32

最大长度:32

project_name

String

项目名

最小长度:1

最大长度:128

description

String

项目描述

project_type

String

项目类型

user_num_id

Integer

创建者的数字id

状态码: 400

表4 响应Body参数

参数

参数类型

描述

error_msg

String

错误描述

error_code

String

错误码

状态码: 401

表5 响应Body参数

参数

参数类型

描述

error_msg

String

错误描述

error_code

String

错误码

请求示例

Post https://{endpoint}/v4/project

{
  "project_name" : "TestDemo",
  "description" : "modify testxxxxx",
  "project_type" : "scrum"
}

响应示例

状态码: 200

OK

{
  "project_num_id" : 708168641,
  "project_name" : "testdemo",
  "project_id" : "2e76d6f0b2c5403796e36bf63c5d5561",
  "user_num_id" : 700145037,
  "project_type" : "scrum",
  "description" : "this is demo"
}

状态码: 400

Bad Request

{
  "error_msg" : "param error",
  "error_code" : "PM.00000001"
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

错误码

请参见错误码