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.
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
| Method | Endpoint | Mô tả |
|---|---|---|
GET | /v1/search | Tì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ểu | Mô tả |
|---|---|---|
q | string | Từ khoá tìm kiếm (bắt buộc) |
types | string | Giới hạn loại: contact,company,deal |
per_page | integer | Số kết quả mỗi trang |
Kiểm thử tại chỗ
GET
https://crm-gateways.hitechcloud.vn/v1/searchKiểm thử tại chỗ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.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
| Method | Endpoint | Mô tả |
|---|---|---|
GET | /v1/search | Tì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ểu | Mô tả |
|---|---|---|
q | string | Từ khoá tìm kiếm (bắt buộc) |
types | string | Giới hạn loại: contact,company,deal |
per_page | integer | Số kết quả mỗi trang |
Kiểm thử tại chỗ
GET
https://crm-gateways.hitechcloud.vn/v1/searchKiểm thử tại chỗNhập từ khoá và Access Token rồi bấm Gửi thử. Token không được lưu lại.
Query
Để 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.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 } }
}