沃土开放平台

API文档 > 设备管理类 > 设备创建接口
URL:http://gs-api.uface.uni-ubi.com/v1/{appId}/device,method:POST
  • 发送设备序列号至沃土云端服务器(后述简称云端),设备录入到云端,也可理解为将设备添加到云端服务器中
  • 设备与URL中写入的appId绑定,设备-appId的对应关系会存在云端服务器中,设备只能绑定一个应用项目
  • 设备创建成功会收到返回信息,appId指应用项目的Id,设备属于这个应用项目;设备状态state应为1:已创建
  • tag(加密,数据存储隔离),用于标记设备聚类,如:不同公司用的设备

设备与云端服务器处于无关联状态,设备将要用于一个新的应用项目

  • 有两种情况:全新的设备,首次创建,首次录入云端;之前创建过,调用设备删除接口断开设备与云端的关联后,可再次创建,重新录入云端
  • tag传入后,服务器会返回加密形式后的tag,可用于设备分类
  • 设备列表查询时,若设备有tag,则需按tag搜索才能找到设备;若搜索条件不传入tag,则搜索范围是无tag的设备
  • "code": "GS_SUS300",//设备录入接口调用成功,指设备确认已经录入到云端服务器中;设备离线则接口调用失败,result=0
字段 描述 类型 必传 说明
appId 应用Id String Y
token 调用接口凭证 String Y
deviceKey 设备序列号 String Y
name 设备名称 String N
tag 设备标签 String N
{
	"code": "GS_SUS300",//设备录入接口调用成功
	"data": {
	"appId": "BEC39FBDF6D94E3798AFB19DDF051234",//应用Id
	"deviceKey": "84E0F4200011ABCD",//设备序列号
	"name": "测试设备",//设备名
	"sceneGuid": "string",//设备场景guid
	"tag": "string",//设备tag(加密)
}