更新时间:2025-07-11 GMT+08:00
分享

下载附件

功能介绍

附件下载操作需基于已上传的附件资源。上传附件时,需调用/v1/{ticket_type}/attachments接口完成上传;成功上传后,可从接口响应中获取doc_id参数。下载附件时,凭借此doc_id再次调用/v1/{ticket_type}/attachments接口,即可获取已上传的对应附件资源,实现附件全生命周期管理。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

GET /v1/{ticket_type}/attachments/{doc_id}

表1 路径参数

参数

是否必选

参数类型

描述

ticket_type

String

参数解释:

工单类型,此处传递固定值incident。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

doc_id

String

参数解释:

需要下载的文件唯一ID。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

请求参数

响应参数

状态码:200

请求成功,响应头中Content-Type值为application/octet-stream,表示该接口返回的为文件流。

更多状态码请参考状态码

状态码:400

表2 响应Body参数

参数

参数类型

描述

provider_code

String

参数解释:

服务标识。

取值范围:

不涉及

默认取值:

049

error_code

String

参数解释:

请求响应代码。

取值范围:

GOM.00000000~GOM.00009999999

默认取值:

GOM.00000000

error_msg

String

参数解释:

请求响应描述。

取值范围:

不涉及

默认取值:

不涉及

请求示例

下载附件请求示例。

GET https://{Endpoint}/v1/incident/attachments/c70d6b38-3783-4d62-9c4a-c6924925e848

响应示例

状态码:400

服务器未能处理请求。

更多状态码请参考状态码

{
  "error_code" : "GOM.00007256",
  "error_msg" : "参数错误",
  "provider_code" : "049",
  "data" : null
}

状态码

状态码

描述

200

请求成功,响应头中Content-Type值为application/octet-stream,表示该接口返回的为文件流。

更多状态码请参考状态码

400

服务器未能处理请求。

更多状态码请参考状态码

错误码

请参见错误码

相关文档