設備命令
平台提供設備命令API，用於直接向設備下發單播指令 API為同步設計，即，當設備收到命令並進行應答時，API返回設備應答內容
請求語法
POST /v1/synccmds?device_id=524092364&timeout=30
<command-content>
URL參數說明
| 版本 | 類型 | 是否必須 | 說明 |
|---|---|---|---|
| device_id | string | Yes | 設備ID |
| timeout | string | Yes | 同步API最長等待時間，取值範圍5－ 30，單位秒 |
body說明
請求body部分為用戶自訂命令數據內容
返回語法
Content-type: application/json
{
"errno": 0,
"error": "success",
"data": {
"cmd_uuid": "f9115090-8ef1-4b0c-aaf4-0678754f575a",
"cmd_resp": "dGhpcyUyMGlzJTIwY29tbWFuZC1yZXNwb25zZSUyMGNvbnRlbnQ="
}
}
返回參數說明
| 參數名稱 | 類型 | 說明 |
|---|---|---|
| errno | int | 錯誤碼 |
| error | string | 錯誤描述 |
| cmd_uuid | string | 命令ID |
| cmd_resp | string | 設備應答內容，base64編碼格式 |
返回錯誤碼
| 錯誤碼 | 錯誤描述 | 說明 |
|---|---|---|
| 12 | device not found | 設備不存在 |
| 13 | device not online | 設備不在線 |
| 14 | cmd response timeout | 設備命令應答超時 |
返回錯誤示例：
{
"errno": 14,
"error": "cmd response timeout"
}
使用限制
命令請求body數據長度必須小於1k
設備應答時payload 長度必須小於1k