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.
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ục | Giá trị |
|---|---|
| Method | POST |
| URL | https://speaker-api.hitechcloud.vn/devices/v1/speaker/list |
| Headers | Authorization: Bearer <TOKEN>, Content-Type: application/json |
Danh sách tham số chi tiết
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
page | number | Không | Số trang, bắt đầu từ 1 (mặc định 1) |
limit | number | Không | Số thiết bị mỗi trang, tối đa 100 (mặc định 20) |
status | string | Không | Lọ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"
}
]
}
}POST
https://speaker-api.hitechcloud.vn/devices/v1/speaker/listKiểm thử tại chỗKết quả được phân trang; dùng `page` và `limit` để duyệt toàn bộ thiết bị.
Body
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ục | Giá trị |
|---|---|
| Method | POST |
| URL | https://speaker-api.hitechcloud.vn/devices/v1/speaker/list |
| Headers | Authorization: Bearer <TOKEN>, Content-Type: application/json |
Danh sách tham số chi tiết
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
page | number | Không | Số trang, bắt đầu từ 1 (mặc định 1) |
limit | number | Không | Số thiết bị mỗi trang, tối đa 100 (mặc định 20) |
status | string | Không | Lọc theo trạng thái: online, offline, all (mặc định all) |
POST
https://speaker-api.hitechcloud.vn/devices/v1/speaker/listKiểm thử tại chỗKết quả được phân trang; dùng `page` và `limit` để duyệt toàn bộ thiết bị.
Body
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"
}
]
}
}