多協議接入產品介紹

產品簡介產品架構資源模型協議適用場景名詞解釋

快速入門

帳戶與登入

帳戶註冊帳戶認證

產品與設備

創建產品創建單個設備批量創建設備批量匯出設備

數據流與數據點

用戶指南

規則引擎

服務介紹規則配置基礎數據格式 SQL

HTTP推送

服務介紹服務配置開發指南 SDK

安全鑒權

概述 token演算法演算法示例

應用管理

服務介紹控制項介紹操作說明

開發指南

EDP

設備開發

文檔與工具協議介紹開發流程常見問題

API

API使用 SDK API列表

新增設備註冊設備更新設備查詢設備詳情批量查詢設備詳情批量查詢設備狀態刪除設備新增數據流更新數據流查詢數據流批量查詢數據流刪除數據流查詢設備歷史數據批量查詢設備數據上載數據點上載文件獲取文件發送命令查詢命令狀態查詢命令回應查詢設備歷史命令新增觸發器更新觸發器查詢觸發器刪除觸發器新增apikey 更新apikey 查詢apikey 刪除apikey

TCP透傳

設備開發

文檔與工具協議介紹開發流程

API

API使用 SDK API列表

新增設備註冊設備更新設備查詢設備詳情批量查詢設備詳情批量查詢設備狀態刪除設備新增數據流更新數據流查詢數據流批量查詢數據流刪除數據流查詢設備歷史數據批量查詢設備數據上載數據點上載文件獲取文件發送命令查詢設備歷史命令新增觸發器更新觸發器查詢觸發器刪除觸發器新增apikey 更新apikey 查詢apikey 刪除apikey

MQTT

設備開發

文檔與工具協議介紹開發流程常見問題

API

API使用 SDK API列表

新增設備註冊設備更新設備查詢設備詳情查詢設備詳情批量查詢設備詳情刪除設備新增數據流更新數據流查詢數據流批量查詢數據流刪除數據流查詢設備歷史數據批量查詢設備數據上載數據點上載文件獲取文件發送命令查詢命令狀態查詢命令回應查詢設備歷史命令新增觸發器更新觸發器查詢觸發器刪除觸發器新增apikey 更新apikey 查詢apikey 刪除apikey 發佈消息查詢訂閱topic設備查詢設備訂閱topic 查詢產品topic

Modbus

設備開發

文檔與工具協議介紹開發流程

API

API使用 SDK API列表

新增設備更新設備查询设备详情批量查詢設備詳情批量查詢設備狀態刪除設備新增數據流更新數據流查詢數據流批量查詢數據流刪除數據流查詢設備歷史數據批量查詢設備數據上載數據點發送命令查詢命令狀態查詢命令回應查詢設備歷史命令新增觸發器更新觸發器查詢觸發器刪除觸發器新增apikey 更新apikey 查詢apikey 刪除apikey

HTTP

API使用 SDK 協議介面清單

新增設備註冊設備更新設備查詢設備詳情批量查詢設備詳情批量查詢設備狀態刪除設備新增數據流更新數據流查詢數據流批量查詢數據流刪除數據流查詢設備歷史數據批量查詢設備數據上載數據點上載文件獲取文件查询设备历史命令新增觸發器更新觸發器查詢觸發器刪除觸發器新增apikey 更新apikey 查詢apikey 刪除apikey

常見問題

平台地址清單技術類商務類 OCP類

批量查詢設備信息

請求方式：GET

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

URL參數

參數名稱	格式	是否必須	說明
key_words	string	否	匹配關鍵字，從id和title欄位中左匹配
auth_info	string	否	鑒權信息
tag	array-string	否	設備標籤
online	bool	No	設備在線狀態
private	bool	No	設備私密性
page	int	No	指定頁碼，最大頁數為10000
per_page	int	No	指定每頁輸出設備個數，預設30，最多100
device_id	string	否	指定設備ID，多個用逗號分隔，最多100個
begin	string	否	起始時間，北京時間，示例：6/20/2016
end	string	否	結束時間，北京時間，示例：6/20/2016

返回參數

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

data描述表

參數名稱	格式	說明
total_count	int	查詢結果中設備的數量
page	int	當前頁
per_page	int	每頁設備數量
devices	array-json	設備信息的json陣列，見devices描述表

devices描述表

參數名稱	格式	說明
protocol	string	設備接入協議
create_time	string	設備創建時間，北京時間
online	bool	設備在線狀態
id	string	設備ID
auth_info	string	設備鑒權信息，對應設備註冊介面中的“sn”或者“mac”參數
title	string	設備名
desc	string	設備描述
tags	array-string	設備標籤
location	json	設備位置座標信息，以經緯度鍵值對表示：{“lon”:xx，“lat”:xx}
other	json	其他設備自訂信息，以鍵值對格式表示，見示例

請求示例1

查詢創建時間為2017-02-04至2017-06-04的標籤為china的在線設備

GET http://api.onenet.hk.chinamobile.com/devices?begin=2017-02-04&end=2017-06-04&online=true&tag=china HTTP/1.1

請求示例2

查詢設備ID為35282992，35271941的兩個設備

GET http://api.onenet.hk.chinamobile.com/devices?device_id=35282992,35271941 HTTP/1.1

請求示例3

查詢該產品下所有的設備

GET http://api.onenet.hk.chinamobile.com/devices HTTP/1.1

返回示例

{
    "errno": 0,
    "data": {
        "per_page": 30,
        "devices": [{
            "protocol": "EDP",
            "other": {
                "version": "1.0.0",
                "manufacturer": "china mobile"
            },
            "create_time": "2018-06-04 17:43:11",
            "online": true,
            "location": {
                "lat": 23.54,
                "lon": 109
            },
            "id": "35282992",
            "auth_info": "tes01235n82105",
            "title": "test_device",
            "desc": "test_desc",
            "tags": ["china", "mobile"]
        }, {
            "protocol": "EDP",
            "create_time": "2018-06-04 11:15:38",
            "online": true,
            "id": "35271941",
            "auth_info": "tes810372105",
            "title": "test_device",
            "tags": ["china"]
        }],
        "total_count": 2,
        "page": 1
    },
    "error": "succ"
}

个搜索结果，搜索内容 “”

0 个搜索结果，搜索内容 “”