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.

Xem Markdown

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ụcGiá trị
MethodPOST
URLhttps://speaker-api.hitechcloud.vn/devices/v1/speaker/config
HeadersAuthorization: Bearer <TOKEN>, Content-Type: application/json

Danh sách tham số chi tiết

Tham sốKiểuBắt buộcMô tả
hardwareIdstringCóSố sê-ri phần cứng của loa cần cấu hình
volumenumberKhôngMức âm lượng từ 0 (tắt) đến 10 (lớn nhất)
defaultVoicestringKhôngGiọng đọc mặc định, ví dụ NORTHERN_FEMALE
repeatnumberKhôngSố lần lặp lại mỗi thông báo (1 đến 3)
quietHoursstringKhôngKhung 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"
  }
}
POSThttps://speaker-api.hitechcloud.vn/devices/v1/speaker/config

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.