Skip to main content

通信协议

MQTT​

项目值
Brokermqtt.imcuer.com
端口1883 (明文) / 8883 (TLS)
版本MQTT 3.1.1
Keepalive60 ~ 120 s

Topic 约定​

# 上行
imcuer/{device_id}/telemetry   # 遥测 JSON
imcuer/{device_id}/event       # 事件
imcuer/{device_id}/ota/status  # OTA 进度

# 下行
imcuer/{device_id}/cmd         # 控制指令
imcuer/{device_id}/ota/firmware

遥测格式​

{
  "ts": 1730000000,
  "data": {
    "temp": 23.4,
    "humidity": 48.1,
    "vbat": 3850
  }
}

鉴权​

POST https://api.imcuer.com/v1/device/activate
Body: { "imei": "861234567890123", "token": "xxxx" }

返回设备证书，后续 MQTT 使用 TLS + 证书双向鉴权。

HTTPS 接口​

接口方法说明
/v1/device/activatePOST首次激活
/v1/device/{id}/stateGET设备状态
/v1/device/{id}/otaGETOTA 元信息
/v1/lbs/queryPOSTLBS 定位