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

查詢apikey

請求方式:GET

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

URL參數

參數名稱 格式 是否必須 說明
key string 用於查詢單獨apikey詳情
device_id string 用於查詢與某設備ID相關的apikey
page string 指定頁碼
per_page string 每頁輸出個數,默認10,最多為100

返回參數

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

data描述表

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

keys描述表

參數名稱 格式 說明
create_time string 創建時間,示例:2017-08-22 11:52:29
key string apikey內容
permissions array-json 訪問資源許可權(見新增api)
title string apikey名稱

請求示例1

查詢某一apikey詳情

GET http://api.onenet.hk.chinamobile.com/keys?key=7RM**************ao= HTTP/1.1

返回示例1

{
    "errno": 0,
    "data": {
        "per_page": 1,
        "total_count": 1,
        "keys": [{
            "title": "new1apikey",
            "create_time": "2017-08-22 11:52:29",
            "key": "7RM**************ao=",
            "permissions": [{
                "resources": [{
                    "dev_id": "39593230"
                }]
            }]
        }],
        "page": 1
    },
    "error": "succ"
}

請求示例2

查詢某一設備關聯的apikey詳情

GET http://api.onenet.hk.chinamobile.com/keys?device_id=39593230 HTTP/1.1

返回示例2

{
    "errno": 0,
    "data": {
        "per_page": 30,
        "total_count": 2,
        "keys": [{
            "create_time": "2017-08-22 11:52:29",
            "permissions": [{
                "resources": [{
                    "dev_id": "39593230"
                }]
            }],
            "title": "new1apikey",
            "key": "7RM**************ao="
        }, {
            "create_time": "2017-08-23 09:01:45",
            "permissions": [{
                "resources": [{
                    "ds_id": "1312",
                    "dev_id": "39593230"
                }, {
                    "dev_id": "39456825"
                }]
            }],
            "title": "new2apikey",
            "key": "F=***************RQ="
        }],
        "page": 1
    },
    "error": "succ"
}

个搜索结果,搜索内容 “

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