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.

Xem Markdown

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

MethodEndpointMô tả
GET/api/v1/shops/{shop_id}/customersDanh sách khách hàng

Tham số

Tham sốVị tríKiểuBắt buộcMô tả
shop_idđường dẫnstringCóID cửa hàng
page_numbertruy vấnintegerKhôngSố thứ tự trang
page_sizetruy vấnintegerKhôngSố bản ghi mỗi trang (tối đa 100)
searchtruy vấnstringKhôngTìm theo tên/SĐT
selectedLeveltruy vấnstring[]KhôngLọc theo hạng khách

Kiểm thử tại chỗ

GEThttps://pos.hitechcloud.vn/api/v1/shops/{shop_id}/customers

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
    }
  }
}