新建工作项

POST 
/project/issues

新建工作项

History

Version	Changes
v3.14.117, v3.15.26	Added in: v3.14.117, v3.15.26

Request

Query Parameters

teamID stringrequired

团队ID

application/json

Body

required

要新建的工作项信息

assignee stringrequired

Possible values: non-empty and <= 8 characters

工作项负责人

title stringrequired

Possible values: non-empty and <= 1024 characters

工作项标题

projectID stringrequired

Possible values: non-empty and <= 16 characters

工作项所属项目ID

issueTypeID stringrequired

Possible values: non-empty and <= 8 characters

工作项类型ID

fieldValues

object[]

required

工作项属性信息

Array [

fieldID stringrequired

Possible values: >= 8 characters

属性ID

type integerrequired

属性类型（以下为常见类型示例）:

• 1: 单选
• 2: 文本
• 3: 整数
• 4: 浮点数
• 5: 日期
• 6: 时间
• 8: 用户
• 13: 用户列表
• 14: 数字
• 16: 多选
• 19: 布尔值

value

object

required

属性值。根据属性类型的不同，返回相应的数据格式。由于类型可扩展，具体格式需要参考返回数据

oneOf

MOD1

string

MOD2

integer

MOD3

boolean

MOD4

Array [

]

]

watchers string[]required

Possible values: non-empty and <= 8 characters

当工作项发生变化时，将通过邮件等方式通知关注者

parentID string

Possible values: non-empty and <= 16 characters

父工作项ID

Responses

200

请求成功

application/json

Schema

Schema

data

object

id string

工作项ID

number integer

工作项编号

title string

工作项标题

projectID string

工作项所属项目ID

issueTypeID string

工作项类型ID

parentID string

父工作项ID

result string

本次请求结果,SUCCESS|FAIL

errorCode string

本次请求错误码

errorMsg string

本次请求错误信息

errorData object

本次请求错误元数据

Example (from schema)

[
  {
    "result": "SUCCESS",
    "data": {
      "id": "5f1f3b93",
      "number": 1,
      "title": "测试工作项",
      "projectID": "5f1f3b93kijun654",
      "issueTypeID": "njkib897",
      "parentID": "tgmlo876"
    }
  },
  {
    "result": "FAIL",
    "errorCode": "NotFound",
    "errorMsg": "NotFound issue"
  },
  {
    "result": "FAIL",
    "errorCode": "AlreadyExists",
    "errorMsg": "AlreadyExists issue"
  },
  {
    "result": "FAIL",
    "errorCode": "NotFound",
    "errorMsg": "NotFound parentIssue"
  }
]

401

如果身份验证凭据不正确或丢失，则返回

application/json

Schema

Schema

result string

本次请求结果,SUCCESS|FAIL

errorCode string

本次请求错误码

errorMsg string

本次请求错误信息

Example (from schema)

{
  "result": "FAIL",
  "errorCode": "Unauthorized",
  "errorMsg": "Access token is invalid"
}

403

如果scope检验不通过，则返回

application/json

Schema

Schema

result string

本次请求结果,SUCCESS|FAIL

errorCode string

本次请求错误码

errorMsg string

本次请求错误信息

Example (from schema)

{
  "result": "FAIL",
  "errorCode": "Forbidden",
  "errorMsg": "Scope is invalid"
}

404

如果未找到资源对象，则返回

application/json

Schema

Schema

result string

本次请求结果,SUCCESS|FAIL

errorCode string

本次请求错误码

errorMsg string

本次请求错误信息

Example (from schema)

{
  "result": "FAIL",
  "errorCode": "NotFound",
  "errorMsg": "Not Found"
}

500

内部服务器错误

application/json

Schema

Schema

result string

本次请求结果,SUCCESS|FAIL

errorCode string

本次请求错误码

errorMsg string

本次请求错误信息

Example (from schema)

{
  "result": "FAIL",
  "errorCode": "Internal Server Error",
  "errorMsg": "Internal Server Error"
}

Loading...