账号管理

账号类型

类型	含义
品牌商账号	此账号不支持注册。 该账号会绑定对应的 OEM SaaS 登录域名，向涂鸦购买 OEM SaaS 时提供的主账号。
企业主账号	您自主注册的账号均为企业主账号，拥有企业内的所有权限，可以创建和删除项目。
企业子账号	SaaS 端登录企业主账号可创建企业子账号，为其分配权限，可限定访问特定功能。

注册账号

暂不支持 App 端主账号注册的功能，请在 涂鸦商照管理平台 开通企业主账号。

登录账号

账号体系设计为一个账号对应多个商户的模型。但目前商业照明限制为一对一，一个账号仅对应一个唯一商户。所以在登录时无需传入商户 Code，后台可以查询到当前账号对应的唯一商户。

登录方式支持：

• 账号密码登录

• 账号验证码登录

• 三方系统授权登录：该方法需配合 商用照明 OpenAPI 使用

  

  授权流程

  1. 三方系统服务端授权账户到涂鸦，由三方系统决定授权账号的范围，可以是三方系统的用户或员工账号，也可以是内部任何业务形态对应一个账号授权到涂鸦。例如，企业、门店和项目等。
  2. 已经授权的账号，三方系统服务端通过账户加国家码，向涂鸦申请一个 Ticket。

  使用场景

  1. 涂鸦的系统域名加上该 Ticket，可实现免登跳转。示例：lighting.console.tuyacn.com?ticket=xxx。例如，可以访问涂鸦的系统网站，或扫码访问设备控制 H5 页面。
  2. 涂鸦商照 SDK 获取会话接口，传入 Ticket，获取会话状态，访问完整的 SDK 能力。

接口说明

- (void)loginMerchantByTicket:(nonnull NSString *)ticket
         multiMerchantHanlder:(void(^_Nullable)(NSArray<ThingSmartMerchantModel *> * _Nonnull merchantInfos))multiMerchantHanlder
                      success:(nullable ThingSuccessHandler)success
                      failure:(nullable ThingFailureError)failure;

参数说明

参数	说明
ticket	通过授权流程获取 Ticket

示例代码

    [ThingSmartUser.sharedInstance loginMerchantByTicket:@"" multiMerchantHanlder:^(NSArray<ThingSmartMerchantModel *> * _Nonnull merchantInfos) {

    } success:^{

    } failure:^(NSError *error) {

    }];

找回或重置密码

此场景适用于忘记密码时，需要找回密码或重置密码。二者操作步骤相同，查询商户列表前需要验证权限。分为三个步骤：

1. 获取找回密码的验证码。
2. 将验证码传入查找商户列表。
3. 获取对应单独商户，执行找回密码的方法修改密码。

更多详情，查看使用说明。

登出账号

账户基本信息存储和清除均在 SDK 内部处理，您无需关心账号信息的安全与同步。

登录成功后，SDK 会缓存账号基本信息。调用账号登出成功后，SDK 也会清空当前账号缓存数据，您只需在成功回调后，自行处理自己的业务逻辑即可。

更多详情，查看使用说明。

注销账号

企业主账号暂不支持账号注销功能，请在涂鸦开发者平台 提交工单 进行人工审核。

绑定账号

目前，商户账号体系暂不支持对账号设置绑定信息的功能。例如，手机号注册的账户进行绑定邮箱，或邮箱注册的账户进行绑定手机号。

查询用户信息

账号固有属性（账号名和账号角色等）会在登录成功后作为账号属性返回。用户附加属性（昵称和头像等）则不会在登录成功后返回，需要通过 获取用户信息 额外查询。

同时 获取用户信息 可以在进行多端数据同步的场景下使用，其他端修改了用户附加属性，通过此方法同步最新数据。