調用該接口根據Token校驗并綁定設備。
路徑 | /awss/token/user/bind |
版本號 | 1.0.8 |
協議 | HTTP,HTTPS |
請求方法 | POST |
是否需要用戶身份鑒權 | 是 |
超時時間 | 15000 |
請求參數
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
---|---|---|---|---|
productKey | String | 是 | 產品的Key,設備證書信息之一。創建產品時,生活物聯網平臺為該產品頒發的全局唯一標識。 | |
deviceName | String | 是 | 設備的名稱,設備證書信息之一。在注冊設備時,自定義的或系統生成的設備名稱,具備產品維度內的唯一性。該參數不為空時,productKey不能為空。 | |
token | String | 是 | 設備上傳的生活物聯網平臺 Token。App可調用/living/awss/token/create接口獲取該 Token。 | |
origin | String | 否 | 業務來源。 | |
userId | String | 否 | 用戶的ID。 | |
userType | String | 否 | 用戶的類型。 | |
groupIds | List | 否 | ["group1","group2"] | 空間ID數組。空間的ID是生活物聯網平臺賦予空間的唯一標識符。 |
homeId | String | 否 | 所屬家的ID,生活物聯網平臺賦予家的唯一標識符。 |
返回數據
名稱 | 類型 | 示例值 | 描述 |
---|---|---|---|
code | Int |
接口返回碼。200表示成功。 |
|
message | String |
調用失敗時,返回的出錯信息。 |
|
localizedMsg | String |
本地語言的錯誤消息。 |
|
data | JSON |
響應的結果。 |
|
iotId | String |
設備ID,生活物聯網平臺為設備頒發的ID,設備的唯一標識符。 |
|
categoryKey | String |
類目鍵。 |
|
pageRouterUrl | String |
頁面路由的鏈接。 |
示例
請求示例
{
"id": "1509086454180",
"version": "1.0",
"request":{
"apiVer": "1.0.8",
"iotToken": "token"
},
"params":{
"productKey": "value0",
"deviceName": "value1",
"token": "value2",
"origin": "value3",
"userId": "value4",
"userType": "value5",
"groupIds":[
"group1",
"group2"
],
"homeId": "value7"
}
}
正常返回示例
JSON
格式
{
"id":"67eae32e-8b85-4040-932a-66a5050b597b",
"code":200,
"message":null,
"localizedMsg":null,
"data":{
"iotId":"VU6b9DNFxVHQ****dldF000101",
"categoryKey":"C****a",
"pageRouterUrl":"page/lvcamera/devicepanel"
}
}
異常返回示例
JSON
格式
{
"id":"75d5c694-eaae-49f1-9562-44004b32c7c6",
"code":5005,
"message":"product not found",
"localizedMsg":"product not found",
"data":null
}