调用该接口根据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
}