API Danh sách thiết bị Loa

Lấy danh sách toàn bộ loa SoundBox đã liên kết với tài khoản cùng trạng thái online, pin và cửa hàng.

Xem Markdown

Endpoint trả về danh sách phân trang các thiết bị loa thuộc tài khoản của bạn, kèm trạng thái kết nối và thông tin cửa hàng. Phù hợp để dựng bảng điều khiển giám sát toàn bộ điểm bán.

Đặc tả Endpoint

MụcGiá trị
MethodPOST
URLhttps://speaker-api.hitechcloud.vn/devices/v1/speaker/list
HeadersAuthorization: Bearer <TOKEN>, Content-Type: application/json

Danh sách tham số chi tiết

Tham sốKiểuBắt buộcMô tả
pagenumberKhôngSố trang, bắt đầu từ 1 (mặc định 1)
limitnumberKhôngSố thiết bị mỗi trang, tối đa 100 (mặc định 20)
statusstringKhôngLọc theo trạng thái: online, offline, all (mặc định all)
cURL lấy danh sách thiết bị
curl -X POST "https://speaker-api.hitechcloud.vn/devices/v1/speaker/list" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "page": 1,
    "limit": 20,
    "status": "all"
  }'
Phản hồi danh sách (200 OK)
{
  "code": 200,
  "message": "Thành công",
  "data": {
    "total": 2,
    "page": 1,
    "limit": 20,
    "devices": [
      {
        "hardwareId": "HTC_S5_2508000001",
        "model": "HiTechCloud SoundBox S5 Plus 4G",
        "storeName": "Cửa hàng Chi nhánh Quận 1",
        "online": true,
        "batteryLevel": 92,
        "volume": 8
      },
      {
        "hardwareId": "HTC_S5_2508000002",
        "model": "HiTechCloud SoundBox S5 Plus 4G",
        "storeName": "Cửa hàng Chi nhánh Quận 3",
        "online": false,
        "lastSeen": "2026-10-31 07:15:00"
      }
    ]
  }
}
POSThttps://speaker-api.hitechcloud.vn/devices/v1/speaker/list

Kết quả được phân trang; dùng `page` và `limit` để duyệt toàn bộ thiết bị.

Body