更新工单

提供修改工单信息的功能.

地址

PUT /v2/accounts/tickets/:ticket_id

鉴权

Authorization: Bearer base64(api_key:api_secret)

请求头

curl --request GET \ --url https://livedesk.engagelab.com/v2/accounts/tickets/:ticket_id \ --H "Content-Type: application/json" \ --H "Authorization: Bearer base64(api_key:api_secret)"

              
              curl --request GET \
  --url https://livedesk.engagelab.com/v2/accounts/tickets/:ticket_id \
  --H "Content-Type: application/json" \
  --H "Authorization: Bearer base64(api_key:api_secret)"

此代碼塊在浮窗中顯示

路径参数

字段	类型	必填	描述
ticket_id	String	是	工单ID。

请求示例

{ "title": "打印机卡纸，无法打印（已更新）", "description": "客户反映A4纸卡在出纸口，急需处理。\n已派技术员前往。", "attachments": [ { "file_url": "https://example.com/files/error-photo.jpg" } ], "priority": "normal", "ticket_type": "incident", "custom_fields": { "department": "IT支持", "device_sn": "PRN-2024-001", "location": "北京总部-3楼打印室", "resolution_note": "更换了进纸器" }, "tags": ["printer", "hardware", "resolved"] }

              
              {
  "title": "打印机卡纸，无法打印（已更新）",
  "description": "客户反映A4纸卡在出纸口，急需处理。\n已派技术员前往。",
  "attachments": [
    {
      "file_url": "https://example.com/files/error-photo.jpg"
    }
  ],
  "priority": "normal",
  "ticket_type": "incident",
  "custom_fields": {
    "department": "IT支持",
    "device_sn": "PRN-2024-001",
    "location": "北京总部-3楼打印室",
    "resolution_note": "更换了进纸器"
  },
  "tags": ["printer", "hardware", "resolved"]
}

此代碼塊在浮窗中顯示

请求参数

字段	类型	必填	描述
title	String	是	工单标题
description	String	是	工单详细描述（支持 Markdown
attachments	Array	否	工单级附件列表
priority	String	否	优先级：low/medium/high/urgent。
ticket_type	String	否	工单类型：incident/question/problem/task
custom_fields	object	否	自定义字段（如设备序列号、订单号等）。
conversation_list	Array	是	工单内所有消息历史。
status_changes	Array	否	工单状态变更记录。
tags	Array	否	工单标签。

attachments

字段	类型	必填	描述
file_url	String	是	文件地址。

custom_fields

字段	类型	必填	描述
device_sn	String	是	关注者ID。
location	String	否	关注者名称。
department	String	否	部门。
resolution_note	String	否	解决记录。

响应示例

成功响应

{ "code": 0, "message": "Success", "data": { "ticket_id": "tk_20251104_789abc", "updated_at": "2025-11-04T10:30:00+08:00" } }

              
              {
  "code": 0,
  "message": "Success",
  "data": {
    "ticket_id": "tk_20251104_789abc",
    "updated_at": "2025-11-04T10:30:00+08:00"
  }
}

此代碼塊在浮窗中顯示

响应参数

字段	类型	必填	描述
ticket_id	String	否	工单ID。
updated_at	String	否	更新时间。