调用该接口根据时间窗口(600秒)校验并绑定设备,从设备上电开始计算。

路径 /awss/time/window/user/bind
版本号 1.0.8
协议 HTTP,HTTPS
请求方法 POST
是否需要用户身份鉴权
超时时间 15000

请求参数

名称 类型 是否必选 示例值 描述
productKey String 产品的Key,设备证书信息之一。创建产品时,生活物联网平台为该产品颁发的全局唯一标识。
deviceName String 设备的名称,设备证书信息之一。在注册设备时,自定义的或系统生成的设备名称,具备产品维度内的唯一性。
groupIds List {} 空间的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",
		"groupIds":{},
		"homeId": "value3"
	}
}

正常返回示例

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
}