多協議接入 產品介紹 快速入門 用戶指南 開發指南
EDP TCP透傳 MQTT Modbus HTTP
常見問題

發送命令

請求方式:POST

URL:http://api.onenet.hk.chinamobile.com/cmds

URL參數

參數名稱 格式 是否必須 說明
device_id string 接收該數據的設備ID
timeout int No 命令有效時間,默認0。 0:在線命令,若設備在線,下發給設備,若設備離線,直接丟棄 >0:離線命令,若設備在線,下發給設備,若設備離線,在當前時間加timeout時間內為有效期,有效期內,若設備上線,則下發給設備 單位:秒 有效範圍:0~2678400

http body內容

用戶自訂數據:json、string、二進位數據(小於64K)

http請求返回參數

參數名稱 格式 說明
errno int 調用錯誤碼,為0表示調用成功
error string 錯誤描述,為“succ”表示調用成功
data json 介面調用成功之後返回的設備相關信息,見data描述表

data描述表

參數名稱 格式 說明
cmd_uuid string 命令id,平台範圍內唯一

請求示例1

P0ST http://api.onenet.hk.chinamobile.com/cmds?device_id=8029377 HTTP/1.1 api-key: l2aH*************BRtAo=

\

返回示例1:成功創建命令

{
    "errno": 0,
    "error": "succ",
    "data": {
        "cmd_uuid": "81572aae-fc34-5deb-8f06-ab45d73cb12b"
    }
}

返回示例2:設備不在線

{
    "errno": 10,
    "error": "device not online: 8029377"
}

請求示例2:發送離線命令

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"
    }
}

个搜索结果,搜索内容 “

    0 个搜索结果,搜索内容 “