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ường | Kiểu dữ liệu | Mô tả |
---|---|---|
ticket_code | string | Mã định danh của ticket 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ú
- 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ỗ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ộ |