請求方式:POST
URL:http://api.onenet.hk.chinamobile.com/cmds
參數名稱 | 格式 | 是否必須 | 說明 |
---|---|---|---|
device_id | string | 是 | 接收該數據的設備ID |
timeout | int | No | 命令有效時間,默認0。 0:在線命令,若設備在線,下發給設備,若設備離線,直接丟棄 >0:離線命令,若設備在線,下發給設備,若設備離線,在當前時間加timeout時間內為有效期,有效期內,若設備上線,則下發給設備 單位:秒 有效範圍:0~2678400 |
用戶自訂數據:json、string、二進位數據(小於64K)
參數名稱 | 格式 | 說明 |
---|---|---|
errno | int | 調用錯誤碼,為0表示調用成功 |
error | string | 錯誤描述,為“succ”表示調用成功 |
data | json | 介面調用成功之後返回的設備相關信息,見data描述表 |
data描述表
參數名稱 | 格式 | 說明 |
---|---|---|
cmd_uuid | string | 命令id,平台範圍內唯一 |
P0ST http://api.onenet.hk.chinamobile.com/cmds?device_id=8029377 HTTP/1.1 api-key: l2aH*************BRtAo=
\
{
"errno": 0,
"error": "succ",
"data": {
"cmd_uuid": "81572aae-fc34-5deb-8f06-ab45d73cb12b"
}
}
{
"errno": 10,
"error": "device not online: 8029377"
}
POST http://api.onenet.hk.chinamobile.com/cmds?device_id=8029377&timeout=3600 HTTP/1.1
api-key: l2aH*************BRtAo=
<this is a command>
{
"errno": 0,
"error": "succ",
"data": {
"cmd_uuid": "81572aae-fc34-5deb-8f06-ab45d73cb12b"
}
}