Chuyển tới nội dung chính

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 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": "[email protected]",
"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",
"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ườngKiểu dữ liệuMô tả
ticket_codestringMã định danh của ticket cần cập nhật (bắt buộc)
ticket_titlestringTiêu đề mới của phiếu hỗ trợ
ticket_contentstring (HTML)Nội dung mới của ticket
account_emailstringEmail khách hàng liên quan
cate_namestringTên danh mục mới
status_namestringTên trạng thái mới
expected_atstring (YYYY-MM-DD)Ngày dự kiến hoàn thành mới
custom_fieldsobjectTrường tùy chỉnh cập nhật mới
emergency_phonestringSố điện thoại khẩn cấp cập nhật

Ghi chú

  • Trường ticket_code là bắt buộc để 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 protected]",
"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",
"ticket_code": "ABCXYZ1234"
}'

Xử lý lỗi

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