調(diào)用該接口根據(jù)批次ID查詢(xún)?cè)O(shè)備證書(shū)的列表。
路徑 | /living/device/apply/query |
版本號(hào) | 1.0.1 |
協(xié)議 | HTTPS |
請(qǐng)求方法 | POST |
是否需要用戶(hù)身份鑒權(quán) | 否 |
超時(shí)時(shí)間 | 5000 |
請(qǐng)求參數(shù)
名稱(chēng) | 類(lèi)型 | 是否必選 | 示例值 | 描述 |
---|---|---|---|---|
applyId | String | 是 | xxxx | 申請(qǐng)的批次ID。 |
pageNo | Int | 是 | 1 | 從1開(kāi)始的查詢(xún)頁(yè)碼。 |
pageSize | Int | 是 | 100 | 分頁(yè)大小,單頁(yè)的記錄上限為 200?。 |
返回?cái)?shù)據(jù)
名稱(chēng) | 類(lèi)型 | 示例值 | 描述 |
---|---|---|---|
code | Int |
接口返回碼。200表示成功。 |
|
message | String |
調(diào)用失敗時(shí),返回的出錯(cuò)信息。 |
|
localizedMsg | String |
本地語(yǔ)言的錯(cuò)誤消息。 |
|
data | JSON |
響應(yīng)結(jié)果。 |
|
totalNum | Long |
該批次的設(shè)備證書(shū)總數(shù)。 |
|
pageNo | Int |
從 1 開(kāi)始的當(dāng)前頁(yè)號(hào)。 |
|
pageSize | Int |
分頁(yè)大小,單頁(yè)的記錄上限為 200?。 |
|
items | JSON |
設(shè)備證書(shū)列表。 |
|
iotId | String |
設(shè)備ID,生活物聯(lián)網(wǎng)平臺(tái)為設(shè)備頒發(fā)的ID,設(shè)備的唯一標(biāo)識(shí)符。 |
|
productKey | String |
產(chǎn)品的Key,設(shè)備證書(shū)信息之一。創(chuàng)建產(chǎn)品時(shí),生活物聯(lián)網(wǎng)平臺(tái)為該產(chǎn)品頒發(fā)的全局唯一標(biāo)識(shí)。 |
|
deviceName | String |
設(shè)備的名稱(chēng),設(shè)備證書(shū)信息之一。在注冊(cè)設(shè)備時(shí),自定義的或系統(tǒng)生成的設(shè)備名稱(chēng),具備產(chǎn)品維度內(nèi)的唯一性。 |
|
deviceSecret | String |
設(shè)備的密鑰,設(shè)備證書(shū)信息之一。在注冊(cè)設(shè)備時(shí)生活物聯(lián)網(wǎng)平臺(tái)為設(shè)備頒發(fā)的設(shè)備密鑰,用于認(rèn)證加密。需與DeviceName成對(duì)使用。 |
|
activeTime | String |
設(shè)備激活的時(shí)間。 |
|
status | Int |
設(shè)備狀態(tài)。0(表示未激活);1(表示在線(xiàn));3(表示離線(xiàn));8(表示禁用)。 |
|
deviceId | String |
設(shè)備的ID,設(shè)備證書(shū)信息之一,具備產(chǎn)品維度內(nèi)的唯一性。 |
示例
請(qǐng)求示例
{
"id": "1509086454180",
"version": "1.0",
"request":{
"apiVer": "1.0.1"
},
"params":{
"applyId": "xxxx",
"pageNo":1,
"pageSize":100
}
}
正常返回示例
JSON
格式
{
"id": "4de2c367-c1db-417c-****-8c585e595d92",
"code": 200,
"message": null,
"localizedMsg": null,
"data": {
"totalNum":0
}
}
異常返回示例
JSON
格式
{
"id": "37f7e5fa-d6a5-4efe-8abf-5bf23dca6284",
"code": 403,
"message": "request forbidden.",
"localizedMsg": "請(qǐng)求被禁止",
"data": null
}