授权管理

只有获得账号的授权许可,第三方应用才能访问与控制该账号下的设备,同时Aqara开发者平台才可把账号下的设备消息推送到第三方服务器。

目前可授权的类型有如下三种:

  • Aqara账号:指通过Aqara Home APP,Aqara开发者平台等其他Aqara系统注册的手机号、邮箱账号,用户可以通过该账号登录到Aqara Home APP,绑定设备、控制设备或联动配置;
  • 项目:指通过物联行业平台创建的项目,用户可以通过提供的入网实施工具进行设备相关入网绑定到该项目;
  • 虚拟账号:指通过开放平台接口创建虚拟Aqara账号,实现与第三方账号体系的打通,用户可以通过开放的SDK或实施工具将设备绑定到该账号。

接口授权

第三方应用可通过API接口获取到用户相关授权许可,以允许第三方应用访问该用户相关信息(如设备列表、控制设备、联动配置等),而无需将用户名和密码提供给第三方应用。

  • 通过API获取Aqara账号授权流程

    步骤1 通过Aqara账号获取授权验证码authCode,验证码通过手机短信或邮箱发送;

    步骤2 通过授权验证码authCode获取访问令牌accessToken;

    步骤3 若访问令牌过期,通过refreshToken刷新访问令牌,获取新的accessToken和refreshToken;

    步骤4 通过accessToken访问其他API接口。

授权流程时序图如下所示,接口详情见Aqara账号授权模式接口页面。

aqara-auth

  • 通过API获取项目授权流程

    步骤1 注册并登录Aqara物联行业平台,创建项目,选择需要授权的项目-选择拓展服务,在获取开放平台权限页面,获取授权验证码authCode;

    步骤2 通过授权验证码authCode获取访问令牌accessToken;

    步骤3 若访问令牌过期,通过refreshToken刷新访问令牌,获取新的accessToken和refreshToken;

    步骤4 通过accessToken访问其他API接口。

授权流程时序图如下所示,接口详情见项目授权模式接口页面。

project-auth

  • 通过API获取虚拟账号授权流程

    步骤1 通过开发者创建的标识账号创建Aqara用户账号,获取虚拟用户唯一标识openid;

    步骤2 通过开发者创建的标识账号获取授权验证码authCode;

    步骤3 通过授权验证码authCode获取访问令牌accessToken;

    步骤4 若访问令牌过期,通过refreshToken刷新访问令牌,获取新的accessToken和refreshToken;

    步骤5 通过accessToken访问其他API接口。

授权流程时序图如下所示,接口详情见虚拟账号授权模式接口页面。

virtual-auth

Copyright © 2023 深圳绿米联创科技有限公司 all right reserved,powered by Gitbook文档修改时间: 2024-02-21 09:55:50

results matching ""

    No results matching ""