Danh sách Ticket

Endpoint: GET /api/v6.1/tickets

Mô tả: API này dùng để lấy danh sách các phiếu hỗ trợ (ticket) từ hệ thống CRM, kèm thông tin chi tiết như tiêu đề, nội dung, danh mục, khách hàng liên quan và các trường tùy chỉnh.

---

Yêu cầu

Phương thức: GET

Headers:

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

Query Parameters:

• fields (tùy chọn): Danh sách các trường cần lấy, 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

Cấu trúc phản hồi:

{
  "data": [
    {
      "id": 1,
      "ticket_title": "Tiêu đề phiếu",
      "ticket_code": "TICKET-12345",
      "ticket_content": "<p>Nội dung hỗ trợ</p>",
      "cate_id": 4,
      "emergency_phone": "0123456789",
      "account_id": 12345,
      "account_name": "Tên khách hàng",
      "custom_fields": {
        "ngay_tich_van_kit": "1740330000"
      }
    }
  ],
  "offset": 0,
  "limited": false,
  "sorted": {
    "id": "DESC"
  }
}

---

Mô tả các trường

Trường	Kiểu dữ liệu	Mô tả
id	integer	ID duy nhất của ticket
ticket_code	string	Mã duy nhất của ticket
ticket_title	string	Tiêu đề ngắn mô tả nội dung ticket
ticket_content	string (HTML)	Nội dung chi tiết của phiếu, có thể bao gồm thẻ HTML
cate_id	integer	ID danh mục ticket (liên kết với API /ticket/categories)
emergency_phone	string	Số điện thoại liên hệ khẩn cấp do người tạo cung cấp
account_id	integer	ID của khách hàng (account) liên quan
account_name	string	Tên khách hàng (account name) liên quan
custom_fields	object	Các trường mở rộng kèm giá trị chi tiết (ví dụ: ngày test kit)

---

Ghi chú

• Trường detail_custom_fields và custom_fields có thể thay đổi tùy theo cấu hình hệ thống.
• Trường thời gian như ngay_tich_van_kit thường là timestamp (giây tính từ epoch).
• API hỗ trợ phân trang qua các tham số offset, limit nếu có.

---

Ví dụ cURL

curl --location 'https://<ten-mien>/api/v6.1/tickets?fields=id,ticket_title,ticket_code,ticket_content,cate_id,emergency_phone,account_id,account_name,custom_fields' \
--header 'X-API-KEY: <api-key>' 

---

Xử lý lỗi

Mã lỗi	Mô tả
401	Không được xác thực – sai API key hoặc phiên đăng nhập
403	Bị từ chối quyền truy cập
500	Lỗi hệ thống nội bộ

---