Tìm kiếm & Lọc

Tìm kiếm và lọc trong HiTechCloud CRM: tìm kiếm toàn văn kết hợp bộ lọc nâng cao trên liên hệ, công ty và cơ hội bán hàng để truy vấn dữ liệu nhanh.

Xem Markdown

HiTechCloud CRM API cung cấp endpoint tìm kiếm thống nhất GET /v1/search và các bộ lọc nâng cao kết hợp nhiều điều kiện theo kiểu AND.

Endpoint tìm kiếm thống nhất

MethodEndpointMô tả
GET/v1/searchTìm kiếm toàn văn trên nhiều loại tài nguyên

Tham số truy vấn

Tham sốKiểuMô tả
qstringTừ khoá tìm kiếm (bắt buộc)
typesstringGiới hạn loại: contact,company,deal
per_pageintegerSố kết quả mỗi trang

Kiểm thử tại chỗ

GEThttps://crm-gateways.hitechcloud.vn/v1/search

Nhập từ khoá và Access Token rồi bấm Gửi thử. Token không được lưu lại.

Query
cURL tìm kiếm toàn văn
curl -X GET "https://crm-gateways.hitechcloud.vn/v1/search?q=nguyen%20van%20a&types=contact,deal" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"
Phản hồi (200 OK)
{
  "status": "success",
  "data": [
    { "type": "contact", "id": "con_8f2a1c9d", "title": "Nguyen Van A", "subtitle": "vana@example.com" },
    { "type": "deal", "id": "deal_a19c330e", "title": "Goi Cloud Server", "subtitle": "24.000.000 VND" }
  ],
  "meta": { "pagination": { "total": 2, "per_page": 20, "current_page": 1, "last_page": 1, "has_more": false } }
}
Để lọc chi tiết theo trường cụ thể, hãy dùng tham số lọc trên từng endpoint danh sách (ví dụ /v1/contacts?lifecycle_stage=customer&tag=vip). Các điều kiện kết hợp theo AND.