v1

latestOpenAPI 3.0.32026-07-17178286472.4 KB
things/product/info
thingsProductInfo

更新产品

post/api/v1/things/product/info/update

Request body

authModeinteger

认证方式:1:账密认证,2:秘钥认证

autoRegisterinteger

动态注册:1:关闭,2:打开,3:打开并自动创建设备,4:在前面的基础上绑定没有也自动创建

bindLevelinteger

绑定级别: 1:强绑定(默认,只有用户解绑之后才能绑定) 2:中绑定(可以通过token强制解绑设备) 3:弱绑定(app可以内部解绑被绑定的设备)

categoryIDinteger

产品品类

createdTimestring

创建时间 只读

customUiobject

自定义ui,key是端的类型(web-client mini-client) value是以下类型的对象{version:123(版本号,只读),isUpdateUi:bool(是否更新ui),path:string(前端路径,如果需要修改,需要将isUpdateUi置为true并在这个参数中传入压缩包的filePath)}

descstring

描述

deviceSchemaModeinteger

设备物模型模式:1:手动创建,2:设备自动创建 3: 设备自动创建及上报无定义自动创建 4: 设备自动创建及上报无定义自动创建(数字类型只使用浮点)

deviceTypeinteger

设备类型:1:直连设备,2:网关,3:子设备,4:监控设备

isUpdateProductImgboolean

只有这个参数为true的时候才会更新产品图片,传参为产品图片的file path

netTypeinteger

通讯方式:1:其他,2:wi-fi,3:2G/3G/4G,4:5G,5:BLE,6:LoRaWAN,7:wifi+ble,8:有线网,9:4G+BLE

onlineHandleinteger

在线处理:1: 自动 2: 永远在线

productIDstring

产品id 只读

productImgstring

产品图片

productNamestring

产品名称

protocolCodestring

协议code,默认urMqtt,设备下发只会发送给主协议 urMqtt,urHttp,wumei,aliyun,huaweiyun,tuya

sceneModestring

场景模式 读写类型: r(只读) rw(可读可写) none(不参与场景)

secretstring

动态注册产品秘钥 只读

statusinteger

产品状态 1:启用 2:禁用 3:开发中

subDeviceOnlineHandleinteger

子设备在线处理:1:自动(跟随网关下线) 2:独立(不跟随)

subProtocolCodestring

子协议,主协议和子协议传输类型必须不相同, 设备控制下发只会发送给主协议, 当设备是音视频设备但是控制协议需要单独走的时候就可以把主协议定义为普通协议,子协议定义为音视频协议,这样就能实现音视频走音视频协议,控制走子协议

tenantCodestring

租户号,common 为公共的产品,公共的大家都可以看,但是只有default可以修改

trialTimestring

试用时间(单位为天,为0不限制)

Response

A successful response.

codeinteger
msgstring