Tạo mới Ticket

Endpoint: POST /api/v6.1/ticket

Mô tả: API này dùng để tạo mới một phiếu hỗ trợ (ticket) trong hệ thống. Dữ liệu bao gồm tiêu đề, nội dung, thông tin liên hệ, danh mục, trạng thái và các trường tuỳ chỉnh.

---

Yêu cầu

Phương thức: POST

Headers:

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

Body (JSON):

{
  "ticket_title": "Tiêu đề phiếu",
  "ticket_content": "<p>Nội dung hỗ trợ</p>",
  "cate_name": "Danh mục hỗ trợ",
  "account_email": "[email protected]",
  "account_code": "ma-khach-hang",
  "contact_name": "Tên người liên hệ",
  "status_name": "Trạng thái ban đầu",
  "expected_at": "2025-01-01",
  "custom_fields": {
    "truong_tuy_chinh": "giá trị"
  },
  "emergency_phone": "0123456789"
}

---

Phản hồi

Trạng thái: 200 OK

Nội dung mẫu:

{
  "message": "Thêm mới thành công",
  "data": {
    "identity": 10,
    "ticket_code": "ABCXYZ1234"
  }
}

---

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

Trường	Kiểu dữ liệu	Mô tả
ticket_title	string	Tiêu đề của phiếu hỗ trợ
ticket_content	string (HTML)	Nội dung chi tiết, có thể có định dạng HTML
cate_name	string	Tên danh mục phiếu hỗ trợ
account_email	string	Email của khách hàng
account_code	string	Mã định danh khách hàng trong hệ thống
contact_name	string	Tên người liên hệ
status_name	string	Trạng thái ban đầu của ticket
expected_at	string (YYYY-MM-DD)	Ngày dự kiến xử lý
custom_fields	object	Các trường tuỳ chỉnh do hệ thống cấu hình
emergency_phone	string	Số điện thoại liên hệ khẩn cấp

---

Ghi chú

• Các trường như cate_name và status_name phải trùng khớp với dữ liệu cấu hình hệ thống.
• custom_fields là object chứa các key tương ứng với trường mở rộng.

---

Ví dụ cURL

curl --location '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 đề phiếu",
  "ticket_content": "<p>Nội dung hỗ trợ</p>",
  "cate_name": "Danh mục",
  "account_email": "[email protected]",
  "account_code": "ma-khach-hang",
  "contact_name": "Người liên hệ",
  "status_name": "Trạng thái",
  "expected_at": "2025-01-01",
  "custom_fields": { "truong_mo_rong": "giá trị" },
  "emergency_phone": "0123456789"
}'

---

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 được xác thực
403	Không có quyền thực hiện
500	Lỗi hệ thống nội bộ

---