Cập nhật Ticket

Endpoint: PUT /api/v6.1/ticket

Mô tả: API này dùng để cập nhật thông tin của một phiếu hỗ trợ (ticket) đã có trong hệ thống, dựa trên một trong hai: current_ticket_id hoặc current_ticket_code.

---

Yêu cầu

Phương thức: PUT

Headers:

Content-Type: application/json
X-API-KEY: <api-key-của-bạn>

Body (JSON):

{
  "ticket_title": "Tiêu đề mới",
  "ticket_content": "<p>Nội dung cập nhật</p>",
  "account_email": "example@email.com",
  "cate_name": "Danh mục mới",
  "status_name": "Trạng thái mới",
  "expected_at": "2025-01-01",
  "custom_fields": {
    "truong_tuy_chinh": "giá trị mới"
  },
  "emergency_phone": "0123456789",
  "current_ticket_code": "ABCXYZ1234"
}

---

Phản hồi

Trạng thái: 200 OK

Nội dung mẫu:

{
  "message": "Cập nhật thành công",
  "data": {
    "identity": 1,
    "ticket_code": "ABCXYZ1234"
  }
}

---

Mô tả các trường đầu vào

Trường	Kiểu dữ liệu	Mô tả
current_ticket_id	integer	ID ticket hiện tại cần cập nhật (bắt buộc)
current_ticket_code	string	Mã định danh của ticket hiện tại cần cập nhật (bắt buộc)
ticket_title	string	Tiêu đề mới của phiếu hỗ trợ
ticket_content	string (HTML)	Nội dung mới của ticket
account_email	string	Email khách hàng liên quan
cate_name	string	Tên danh mục mới
status_name	string	Tên trạng thái mới
expected_at	string (YYYY-MM-DD)	Ngày dự kiến hoàn thành mới
custom_fields	object	Trường tùy chỉnh cập nhật mới
emergency_phone	string	Số điện thoại khẩn cấp cập nhật

---

Ghi chú

• Chỉ cần cung cấp một trong hai: current_ticket_id hoặc current_ticket_code để xác định ticket cần cập nhật.
• Các giá trị khác sẽ thay thế dữ liệu hiện có.

---

Ví dụ cURL

curl --location --request PUT 'https://<ten-mien>/api/v6.1/ticket' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--header 'Cookie: <session-cookie>' \
--data-raw '{
  "ticket_title": "Tiêu đề mới",
  "ticket_content": "<p>Nội dung cập nhật</p>",
  "account_email": "email@domain.com",
  "cate_name": "Danh mục mới",
  "status_name": "Trạng thái mới",
  "expected_at": "2025-01-01",
  "custom_fields": { "truong_mo_rong": "giá trị mới" },
  "emergency_phone": "0123456789",
  "current_ticket_code": "ABCXYZ1234"
}'

---

Xử lý lỗi

Mã lỗi	Mô tả
400	Thiếu hoặc sai định dạng trường bắt buộc
401	Không xác thực
403	Không có quyền cập nhật
404	Không tìm thấy ticket cần cập nhật
500	Lỗi hệ thống nội bộ

---