API Quản lý âm lượng & cấu hình Loa
Điều chỉnh âm lượng, giọng đọc mặc định và các tùy chọn hoạt động của thiết bị loa SoundBox từ xa.
Endpoint cho phép cấu hình thiết bị loa từ xa: đặt mức âm lượng phù hợp cho từng khung giờ, chọn giọng đọc mặc định của cửa hàng và bật/tắt các tính năng như lặp lại thông báo.
Đặc tả Endpoint
| Mục | Giá trị |
|---|---|
| Method | POST |
| URL | https://speaker-api.hitechcloud.vn/devices/v1/speaker/config |
| 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ả |
|---|---|---|---|
hardwareId | string | Có | Số sê-ri phần cứng của loa cần cấu hình |
volume | number | Không | Mức âm lượng từ 0 (tắt) đến 10 (lớn nhất) |
defaultVoice | string | Không | Giọng đọc mặc định, ví dụ NORTHERN_FEMALE |
repeat | number | Không | Số lần lặp lại mỗi thông báo (1 đến 3) |
quietHours | string | Không | Khung giờ giảm âm, ví dụ 22:00-06:00 |
cURL cập nhật âm lượng và cấu hình
curl -X POST "https://speaker-api.hitechcloud.vn/devices/v1/speaker/config" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"hardwareId": "HTC_S5_2508000001",
"volume": 7,
"defaultVoice": "NORTHERN_FEMALE",
"repeat": 1
}'Phản hồi thành công (200 OK)
{
"code": 200,
"message": "Đã cập nhật cấu hình thiết bị",
"data": {
"hardwareId": "HTC_S5_2508000001",
"volume": 7,
"defaultVoice": "NORTHERN_FEMALE",
"repeat": 1,
"appliedAt": "2026-10-31 10:40:00"
}
}POST
https://speaker-api.hitechcloud.vn/devices/v1/speaker/configKiểm thử tại chỗCấu hình được đẩy xuống thiết bị ngay khi loa đang trực tuyến.
Body
Nếu loa đang offline, cấu hình sẽ được xếp hàng và áp dụng tự động ngay khi thiết bị kết nối mạng trở lại.
Endpoint cho phép cấu hình thiết bị loa từ xa: đặt mức âm lượng phù hợp cho từng khung giờ, chọn giọng đọc mặc định của cửa hàng và bật/tắt các tính năng như lặp lại thông báo.
Đặc tả Endpoint
| Mục | Giá trị |
|---|---|
| Method | POST |
| URL | https://speaker-api.hitechcloud.vn/devices/v1/speaker/config |
| 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ả |
|---|---|---|---|
hardwareId | string | Có | Số sê-ri phần cứng của loa cần cấu hình |
volume | number | Không | Mức âm lượng từ 0 (tắt) đến 10 (lớn nhất) |
defaultVoice | string | Không | Giọng đọc mặc định, ví dụ NORTHERN_FEMALE |
repeat | number | Không | Số lần lặp lại mỗi thông báo (1 đến 3) |
quietHours | string | Không | Khung giờ giảm âm, ví dụ 22:00-06:00 |
POST
https://speaker-api.hitechcloud.vn/devices/v1/speaker/configKiểm thử tại chỗCấu hình được đẩy xuống thiết bị ngay khi loa đang trực tuyến.
Body
Nếu loa đang offline, cấu hình sẽ được xếp hàng và áp dụng tự động ngay khi thiết bị kết nối mạng trở lại.
cURL cập nhật âm lượng và cấu hình
curl -X POST "https://speaker-api.hitechcloud.vn/devices/v1/speaker/config" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"hardwareId": "HTC_S5_2508000001",
"volume": 7,
"defaultVoice": "NORTHERN_FEMALE",
"repeat": 1
}'Phản hồi thành công (200 OK)
{
"code": 200,
"message": "Đã cập nhật cấu hình thiết bị",
"data": {
"hardwareId": "HTC_S5_2508000001",
"volume": 7,
"defaultVoice": "NORTHERN_FEMALE",
"repeat": 1,
"appliedAt": "2026-10-31 10:40:00"
}
}