API Kiểm tra thiết bị Loa

Xác minh trạng thái kết nối mạng và trạng thái ghép nối của loa thông minh theo số sê-ri phần cứng.

Xem Markdown

Cho phép kiểm tra xem một chiếc loa theo số sê-ri phần cứng (hardwareId) có đang trực tuyến và sẵn sàng phát âm thanh hay không.

Đặc tả Endpoint

MụcGiá trị
MethodPOST
URLhttps://speaker-api.hitechcloud.vn/devices/v1/speaker/pair/check
HeadersAuthorization: Bearer <TOKEN>, Content-Type: application/json
cURL kiểm tra thiết bị
curl -X POST "https://speaker-api.hitechcloud.vn/devices/v1/speaker/pair/check" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "hardwareId": "HTC_S5_2508000001"
  }'
Phản hồi thiết bị Online (200 OK)
{
  "code": 200,
  "message": "Thành công",
  "data": {
    "hardwareId": "HTC_S5_2508000001",
    "model": "HiTechCloud SoundBox S5 Plus 4G",
    "isPaired": true,
    "online": true,
    "batteryLevel": 92,
    "signalStrength": 4,
    "volume": 8,
    "firmwareVersion": "v2.5.0"
  }
}
Phản hồi thiết bị Offline (200 OK)
{
  "code": 200,
  "message": "Thành công",
  "data": {
    "hardwareId": "HTC_S5_2508000001",
    "model": "HiTechCloud SoundBox S5 Plus 4G",
    "isPaired": true,
    "online": false,
    "lastSeen": "2026-10-31 08:30:12"
  }
}