沃土开放平台

API文档 > 设备管理类 > 设备删除接口
URL:http://gs-api.uface.uni-ubi.com/v1/{appId}/device/{deviceKey},method:DELETE
  • 删除云端服务器中存有的设备信息
  • 删除设备-appId的对应关系,即设备与该应用解绑
  • 删除云端服务器中存有的设备-人员的对应关系,但是人员-照片的对应关系保留,即照片还是属于这个人员guid
  • 删除设备内存储的所有人员信息、照片信息,相当于所有人员从设备上销权,设备无法识别人员
  • 设备将要用于一个新的应用项目,需删除原先存在云端的设备信息,与原应用项目解绑,并删除设备内的存储信息
  • 若设备不需要与应用解绑,而只是清空设备存储信息,可调用设备销权人员接口(personGuid为空即可清空所有人员,删除云端的所有设备-人员关系,但设备仍然与appId绑定)或设备重置接口(慎用,会恢复出厂设置,设备app版本(VersionNo)会重置为最新的设备OTA版本)
  • 调用设备创建接口前,需调用设备删除接口将设备-appId解绑,否则重复添加设备会报错
  • 调用过设备删除接口后,不可继续调用业务接口,异常如:重复调用设备删除接口出错;需重新调用设备创建接口后才可调用业务接口
  • "code": "GS_SUS302",//设备删除接口调用成功,指设备已经从云端服务器删除,设备与appId解绑;若设备在线,则云端推送删除操作给设备,并清空设备内存储的人员数据信息;设备离线,则联网后自动进行删除操作
字段 描述 类型 必传 说明
appId 应用Id String Y
token 调用接口凭证 String Y
deviceKey 设备序列号 String Y
{
	"code": "GS_SUS302",//设备删除接口调用成功
	"msg": "success",
	"result": 1
}
接口名称 设备删除 设备重置 设备销权人员(包括清空)
设备-appId绑定关系 解绑 不解绑 不解绑
云端存储的数据信息 删除设备-人员关系 不删除 删除设备-人员关系
设备内存储的数据信息 删除 删除 删除
数据能否恢复 不能 可通过同步恢复 不能
调用后可执行的操作 设备创建 设备同步 清空后可将设备授权给同应用下新的用户群体