上传工单附件

上传单个工单附件并返回可用于后续创建/回复工单的文件 URL。接口按文件内容计算 MD5 并使用该 MD5 参与签名校验；单文件最大 100 MB。上传成功后，返回的 url 可在创建工单或流转操作的附件中作为 type=2(URL) 的 payload 使用。

请求参数

名称	类型	必填	描述
appKey	string	是	应用 AppKey
time	int64	是	请求时间戳（秒）
checksum	string	是	请求签名校验和，使用文件内容 MD5 参与签名
checksumAlgorithm	int32	否	签名算法：0 - 默认(SHA1)，1 - SHA256

请求体

名称	类型	必填	描述	示例值
file	string	是	待上传的附件文件，单文件最大 100 MB。签名 MD5 使用文件内容计算

返回参数

名称	类型	描述	示例值
code	int32	状态码，200 表示成功	200
message	object	上传附件结果	{"url":"https://example.com/openapi/attachment/refund-proof.pdf","fileName":"退款凭证.pdf","size":245760}
└url	string	附件 URL；创建工单时可作为 type=2 的 payload 使用	https://example.com/openapi/attachment/refund-proof.pdf
└fileName	string	原始文件名	退款凭证.pdf
└size	int64	文件大小，单位字节	245760

错误码

状态码	描述
14001	AppKey 不存在
14002	checksum 校验失败
14003	time 缺失或请求时间戳与服务器时间误差超过限制
14004	文件为空或请求参数错误
14107	企业附件总容量超过限制
14500	服务内部异常
16001	企业工单服务不可用

postEndpoint

/openapi/v2/ticket/uploadAttachment

curl -X POST "https://qiyukf.com/openapi/v2/ticket/uploadAttachment?appKey=string&time=0&checksum=string" \  -F file="string"

{
  "code": 200,
  "message": {
    "url": "https://example.com/openapi/attachment/refund-proof.pdf",
    "fileName": "退款凭证.pdf",
    "size": 245760
  }
}

{
  "code": 14001,
  "message": "AppKey 不存在"
}

{
  "code": 14002,
  "message": "checksum 校验失败"
}

{
  "code": 14003,
  "message": "time 缺失或请求时间戳与服务器时间误差超过限制"
}

{
  "code": 14004,
  "message": "文件为空或请求参数错误"
}

{
  "code": 14107,
  "message": "企业附件总容量超过限制"
}

{
  "code": 14500,
  "message": "服务内部异常"
}

{
  "code": 16001,
  "message": "企业工单服务不可用"
}