使用基础服务

更新时间：2019-07-29 18:06:35

实体介绍

租户是IoT平台对于B端用户创建的唯一的身份，所有与人居平台对接过的企业或者开发者，都会有唯一的租户ID作为标识。租户之间，数据是隔离的。

用户是平台的重要业务实体，可以和设备、空间、模块之间创建逻辑关系。通常，用户是企业SaaS平台的用户。用户可以是使用了默认账号系统的用户，直接和人居平台对接，也可以是使用自有账号系统的用户，通过WebOA SDK批量导入用户。

用户在系统中用Identity类型表示，hid字段代表用户标识，hidType字段代表用户账号类型。
使用默认账号系统时，hidType为OA。使用自有账号系统时，hidType为OPEN。

用户在接口中根据场景会使用operator、target等表示，代表操作员、操作目标等。

设备是智能人居开放平台的重要实体，代表一个实际的物理设备。设备先由配网绑定接入到租户，然后通过设备&用户的绑定解绑接口维护用户与设备的逻辑关系。

设备在接口定义中会使用device表示，用iotId表示设备的标识。

空间是设备在现实世界中位置的抽象，例如，小区、单元、幢、房屋、房间、停车场等是属于不同类型的空间，当一个设备与空间绑定后，代表设备“存在”于这个空间中。

空间模板是一种固定的空间框架，用来简化空间的创建，用户可以使用一个空间模板创建出一组配置好的空间。空间可以独立创建出来，也可以通过空间模板创建出多个相似的空间。根据空间模板创建出来的空间具有与模板相同的结构。

空间与空间模板在接口中会使用space和spacetemplate表示。

与空间类似，场景包括场景模板和场景实例，以下场景实例简称场景。场景为用户提供多设备联动、编排的能力，是智能家居的体现。场景可以理解为一组设备联动规则，联动规则分触发器（trigger）、边界条件（condition）和动作（action）三部分。

场景与场景模板在接口中会使用scene和scenetemplate表示。