調用該接口根據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
}