• 把本地的 uu.jpg 上传到空间 755
  • curl 使用 Basic Auth 鉴权调用示例
  • curl 使用 OAuth Access Token 鉴权调用示例
  • 返回结果
• 返回字段说明

说明

通过API上传单个附件，大小上限限制150MB。

url

https://api.tapd.cn/files/upload_attachment

支持格式

JSON/XML（默认JSON格式）

HTTP请求方式

POST

请求数限制

• 每次只允许上传一个文件
• 文件大小限小于150MB

请求参数

字段名	必选	类型及范围	说明
workspace_id	是	integer	空间ID
file	是	文件	文件
type	是	string	类型(固定为story_custom_field)
custom_field	是	string	字段英文名
entry_id	是	integer	工作项ID
owner	否	string	附件创建人

调用示例及返回结果

把本地的 uu.jpg 上传到空间 755

curl 使用 Basic Auth 鉴权调用示例

curl -u 'api_user:api_password' -F 'workspace_id=69993260' -F 'type=story_custom_field' -F 'custom_field=custom_field_one' -F 'entry_id=1069993260856110917' -F 'file=@orangetest.jpg' 'https://api.tapd.cn/files/upload_attachment'

curl 使用 OAuth Access Token 鉴权调用示例

curl -H 'Authorization: Bearer ACCESS_TOKEN' -F 'workspace_id=69993260' -F 'type=story_custom_field' -F 'custom_field=custom_field_one' -F 'entry_id=1069993260856110917' -F 'file=@orangetest.jpg' 'https://api.tapd.cn/files/upload_attachment'

返回结果

{
    "status": 1,
    "data": {
        "Attachment": {
            "id": "1069993260503455439",
            "type": "story_custom_field",
            "entry_id": 1069993260856110917,
            "filename": "orangetest.jpg",
            "description": "",
            "content_type": "image/jpeg",
            "created": "2023-07-07 21:36:08",
            "workspace_id": 69993260,
            "owner": ""
        }
    },
    "info": "success"
}

字段说明

返回字段说明

字段	说明
id	附件id
type	类型(固定为story_custom_field)
entry_id	工作项id
filename	文件名
description	附件描述
content_type	文件类型
created	创建时间