三方系统和账户授权

时序图

授权流程

1. 三方系统服务端授权账户到涂鸦 IoT 开发平台，由三方系统决定授权账户的范围。可以是三方系统的用户或员工账号，也可以是内部任何业务形态对应一个账号授权到涂鸦 IoT 开发平台，例如：企业、门店、项目等。

2. 获取 ticket。对应已经授权的账户，三方系统服务端使用账户加国家码，向涂鸦 IoT 开发平台申请一个 ticket。

3. 使用 ticket 获取会话。

   • 使用场景 1：涂鸦的系统域名加上这个 ticket，可实现免登跳转。比如，访问涂鸦的系统网站，示例：lighting.console.tuyacn.com?ticket=xxxxx。重点案例：设备扫码控制。
   • 使用场景 2：涂鸦商照 SDK 获取会话接口，传入 ticket 获取会话状态，访问完整的 SDK 能力。

API 列表

授予员工账号跳转权限

功能描述

将企业的员工授权到涂鸦 SaaS 平台。

接口地址

POST /v1.0/industry/auth/admin

请求参数

返回参数

result 参数说明

"ay1575258560846OO4lC"

请求示例

{
  "username": "123456",
  "nickName": "xxxx",
  "countryCode": "86"
  }

响应示例

{
   "success":"true",
   "t":1541071460239,
   "result":"ay1575258560846OO4lC"
}

获取登录 ticket

功能描述

获取登录涂鸦 SaaS 平台的 ticket。

接口地址

POST /v1.0/industry/auth/ticket

请求参数

返回参数

result 参数说明

{
result:"12hjklgew2gtywgwxsdgw"
}

请求示例

{
  "username": "186xxxx2790",
  "countryCode":"86"
}

响应示例

{
    "success":true,
    "t":1541071460239,
    "result": "12hjklgew2gtywgwxsdgw"
}

项目空间权限分配

功能描述

为子账号分配项目空间权限。

接口地址

POST /v1.0/illumination/account/permission/add

请求参数

返回参数

result 参数说明

{
  true/false
}

请求示例

{
  "tuyaUid": "ay1563*******1zJw30",
  "projectId": "123324234",
  "roomIdList": ["1420922162969059328"]
}

响应示例

{
    "success":true,
    "t":1541071460239,
    "result": true
}

获取授权账户列表

功能描述

获取账户列表。

接口地址

GET /v1.0/illumination/account/list

请求参数

返回参数

result 参数说明

{
  "total": "int",
  "list": [
    {
      "uid": "String //UID",
      "loginName": "String //登录名",
      "nickName": "String //昵称",
      "roleCode": "String //角色 code",
      "roleName": "String //角色名称",
      "remark": "String //备注",
      "createDate": "String //创建时间",
      "adminId": "String //账户 ID",
      "page": "int",
      "pageSize": "int"
    }
  ]
}

请求示例

{
  "loginName": "xxx",
}

响应示例

{
  "total": "int",
  "list": [
    {
      "uid": "xxxx",
      "loginName": "",
      "nickName": "",
      "roleCode": "",
      "roleName": "",
      "remark": "",
      "createDate": "",
      "adminId": "",
    }
  ]
}