Khách hàng — Danh sách (API)
Danh sách khách hàng với tìm kiếm và lọc theo hạng.
Trả về danh sách khách hàng, lọc theo từ khoá, hạng khách và khoảng thời gian.
Endpoint
| Method | Endpoint | Mô tả |
|---|---|---|
GET | /api/v1/shops/{shop_id}/customers | Danh sách khách hàng |
Tham số
| Tham số | Vị trí | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
shop_id | đường dẫn | string | Có | ID cửa hàng |
page_number | truy vấn | integer | Không | Số thứ tự trang |
page_size | truy vấn | integer | Không | Số bản ghi mỗi trang (tối đa 100) |
search | truy vấn | string | Không | Tìm theo tên/SĐT |
selectedLevel | truy vấn | string[] | Không | Lọc theo hạng khách |
Kiểm thử tại chỗ
GET
https://pos.hitechcloud.vn/api/v1/shops/{shop_id}/customersKiểm thử tại chỗNhập tham số và API Key rồi bấm Gửi thử. Key không được lưu lại.
Tham số đường dẫn
Query
cURL mẫu
curl -X GET "https://pos.hitechcloud.vn/api/v1/shops/shop_0a1b2c3d/customers?page_number=1&page_size=20&search=0901234567&selectedLevel=vip" \
-H "Authorization: Bearer YOUR_API_KEY"Phản hồi mẫu
{
"status": "success",
"data": [
{
"id": "cus_3001",
"name": "Nguyen Van A",
"phone": "0901234567",
"total_spent": 12500000
}
],
"meta": {
"pagination": {
"total": 42,
"page_size": 20,
"page_number": 1,
"total_pages": 3,
"has_more": true
}
}
}Trả về danh sách khách hàng, lọc theo từ khoá, hạng khách và khoảng thời gian.
Endpoint
| Method | Endpoint | Mô tả |
|---|---|---|
GET | /api/v1/shops/{shop_id}/customers | Danh sách khách hàng |
Tham số
| Tham số | Vị trí | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
shop_id | đường dẫn | string | Có | ID cửa hàng |
page_number | truy vấn | integer | Không | Số thứ tự trang |
page_size | truy vấn | integer | Không | Số bản ghi mỗi trang (tối đa 100) |
search | truy vấn | string | Không | Tìm theo tên/SĐT |
selectedLevel | truy vấn | string[] | Không | Lọc theo hạng khách |
Kiểm thử tại chỗ
GET
https://pos.hitechcloud.vn/api/v1/shops/{shop_id}/customersKiểm thử tại chỗNhập tham số và API Key rồi bấm Gửi thử. Key không được lưu lại.
Tham số đường dẫn
Query
cURL mẫu
curl -X GET "https://pos.hitechcloud.vn/api/v1/shops/shop_0a1b2c3d/customers?page_number=1&page_size=20&search=0901234567&selectedLevel=vip" \
-H "Authorization: Bearer YOUR_API_KEY"Phản hồi mẫu
{
"status": "success",
"data": [
{
"id": "cus_3001",
"name": "Nguyen Van A",
"phone": "0901234567",
"total_spent": 12500000
}
],
"meta": {
"pagination": {
"total": 42,
"page_size": 20,
"page_number": 1,
"total_pages": 3,
"has_more": true
}
}
}