文档首页/ 需求管理 CodeArts Req/ API参考/ API/ IPD附件管理/ 上传文件并关联工作项
更新时间：2025-08-11 GMT+08:00
在线调试
CLI示例
查看PDF
分享

上传文件并关联工作项

功能介绍

上传文件并关联工作项。

调用方法

请参见如何调用API。

URI

POST /v1/ipdprojectservice/projects/{project_id}/issues/{issue_id}/attachments/upload

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

项目的32位uuid，项目唯一标识，通过查询项目列表接口获取，响应消息体中的project_id字段的值就是项目ID。

约束限制：

正则表达式，^[A-Za-z0-9]{32}$。

取值范围：

不涉及。

默认取值：

不涉及。

issue_id

是

String

参数解释：工作项唯一Id。可以通过查询工作项列表或者查询树状工作接口获取，响应消息体中的id字段的值就是工作项ID。

约束限制：正则表达式，^([0-9]{18,19})$

默认取值：不涉及

请求参数

表2 FormData参数

参数

是否必选

参数类型

描述

attachment

是

File

参数解释：

附件。

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

status

String

参数解释：

状态

取值范围：

不涉及

message

String

参数解释：

失败信息

取值范围：

不涉及

result

Array of AttachmentVoExt objects

参数解释：

附件上传信息
表4 AttachmentVoExt

参数

参数类型

描述

progress

Integer

参数解释：

上传进度

取值范围：

不涉及

id

String

参数解释：

附件Id

取值范围：

不涉及

workitem_id

String

参数解释：

工作项Id

取值范围：

不涉及

filesize

Long

参数解释：

文件大小

取值范围：

不涉及

store_filename

String

参数解释：

文件存储名

取值范围：

不涉及

title

String

参数解释：

文件名

取值范围：

不涉及

请求示例

POST https://{endpoint}/v1/ipdprojectservice/projects/gdbdf969b32694524a949b5ef6b3e124a/issues/956239067176935400/attachments/upload

------WebKitFormBoundary1kuNerRnRVVybt65
Content-Disposition: form-data; name="attachment"; filename="demo.PNG"
Content-Type: image/png

响应示例

状态码：200

上传成功响应

{
  "status" : "success",
  "message" : null,
  "result" : null
}

状态码

状态码

描述

200

上传成功响应

错误码

请参见错误码。

父主题： IPD附件管理

相关文档