Chi tiết một Ticket

Endpoint: GET /api/v6.1/ticket

Mô tả: API này dùng để truy xuất thông tin chi tiết của một phiếu hỗ trợ (ticket) cụ thể dựa trên mã định danh ticket_code. Kết quả trả về bao gồm các trường cơ bản và tùy chỉnh liên quan đến ticket đó.

---

Yêu cầu

Phương thức: GET

Headers:

X-API-KEY: <api-key-của-bạn>
Cookie: <session-cookie-của-bạn>

Query Parameters:

• ticket_code: Mã định danh của ticket (bắt buộc)
• fields: Danh sách trường cần lấy (tùy chọn), phân cách bằng dấu phẩy. Ví dụ: id,ticket_title,ticket_content,...

---

Phản hồi

Trạng thái: 200 OK

Nội dung mẫu:

{
  "id": 123,
  "ticket_title": "Tiêu đề phiếu",
  "ticket_content": "<p>Nội dung hỗ trợ</p>",
  "cate_id": 1,
  "emergency_phone": "0123456789",
  "account_id": 456,
  "account_name": "Tên khách hàng",
  "custom_fields": {
    "truong_tuy_chinh_1": "giá trị",
    "truong_tuy_chinh_2": null
  }
}

---

Mô tả các trường

Trường	Kiểu dữ liệu	Mô tả
id	integer	ID nội bộ của ticket
ticket_title	string	Tiêu đề của ticket
ticket_content	string (HTML)	Nội dung chi tiết, có thể chứa HTML
cate_id	integer	Mã danh mục của ticket
emergency_phone	string	Số điện thoại liên hệ khẩn cấp
account_id	integer	ID của khách hàng liên quan
account_name	string	Tên khách hàng liên quan
custom_fields	object	Các trường tùy chỉnh của hệ thống, cấu hình động

---

Ghi chú

• ticket_code là bắt buộc và duy nhất cho mỗi ticket.
• Trường custom_fields có thể thay đổi tùy cấu hình từng hệ thống CRM.

---

Ví dụ cURL

curl --location 'https://<ten-mien>/api/v6.1/ticket?fields=id,ticket_title,ticket_content,...&ticket_code=<ma-ticket>' \
--header 'X-API-KEY: <api-key>' \
--header 'Cookie: <session-cookie>'

---

Xử lý lỗi

Mã lỗi	Mô tả
400	Thiếu ticket_code hoặc không hợp lệ
401	Không được xác thực
403	Bị từ chối truy cập
404	Không tìm thấy ticket
500	Lỗi hệ thống nội bộ

---