用户服务

更新时间：2019-01-22 13:06:03

提供一组与用户相关的服务接口，云端应用通过本组服务可以实现用户的解绑，获取用户绑定的设备列表信息等。

• 分页查询用户列表

• 通过三方外标查询账号信息

• 获取用户绑定的设备列表（包括设备详情）详情内容

• 解绑用户和设备

• 根据身份id获取第三方openid

• 根据设备查找所有绑定的用户

• 通过identityid查询账户的详细信息

分页查询用户列表

定义描述

请求参数

返回参数

示例

请求示例

{
     "id":1508232047194,
      "request": {
        "cloudToken": "109049c80bcde4c06b15f6f62e29a3ba",
        "apiVer": "1.0.4"
      },
      "params": {
        "offset":0, "count":1
      },
      "version": "1.0"
}

正常返回示例

{
    "code": 200,
    "data": [
        {
            "gmtModified": 1508314232000,
            "loginId": "4398047084811",
            "gmtCreate": 1508314232000,
            "identityId": "506bop1ef3a1ce8005d731e0df57ae175ac94618",
            "loginSource": "openAccount",
            "loginName":"test",
            "phone":"13888888888",
            "email":"test@aliyun.com",
            "nickName":"test"
        }
    ],
    "id":"bb179e80-39fd-4a79-ba97-48ca87a3f5c5"
}

错误码

通过三方外标查询账号信息

定义描述

请求参数

返回参数

示例

请求示例

{
     "id":1508232047194,
      "request": {
        "cloudToken": "109049c80bcde4c06b15f6f62e29a3ba",
        "apiVer": "1.0.4"
      },
      "params": {
        "openId":"4398050099996", "openIdAppKey":"appkey1"
      },
      "version": "1.0"
}

正常返回示例

{
    "code": 200,
    "data": [
        {
            "gmtModified":1515590332000,
            "loginId":"4398050099996",
            "gmtCreate":1513181985000,
            "lastLoginTime":1515590332000,
            "phone":"15757245467",
            "identityId":"5091op618500614829ee12fae93ba653a5928119",
            "loginName":"15757245467",
            "tenantId":"45CFEA759A994F48A8305D59452B1437",
            "loginSource":"openAccount"
            "email":"test@aliyun.com",
            "nickName":"test"
        }
    ],
    "id":"bb179e80-39fd-4a79-ba97-48ca87a3f5c5"
}

获取用户绑定的设备列表（包括设备详情）详情内容

定义描述

请求参数

返回参数

示例

请求示例

• 传入openId和openIdAppKey

  {
     "id":1508232047194,
      "request": {
        "cloudToken": "109049c80bcde4c06b15f6f62e29a3ba",
        "apiVer": "1.0.4"
      },
      "params": {
        "openId":"10000000001",
        "openIdAppKey":"xxx"
      },
      "version": "1.0"
  }
  

• 传入identityId

  {
     "id":1508232047127,
      "request": {
        "cloudToken": "109049c80bcde4c06b15f6f62e29a3ba",
        "apiVer": "1.0.4"
      },
      "params": {
        "identityId": "506bop1ef3a1ce8005d731e0df57ae175ac94618"
      },
      "version": "1.0"
  }
  

正常返回示例

{
    "code": 200,
    "data": {
        "code": 200,
        "data": [{
            "iotId": "VPuHLddp6fisYryXdk0T0010dbd910",
            "identityId": "50ceop3441838d879e23f01933ab455be61f0356",
            "netType": "NET_WIFI",
            "thingType": "DEVICE",
            "productKey": "a1FNS8TYhpQ",
            "deviceName": "VD_sdDaqyTXeQ",
            "productName": "风扇3-复制",
            "status": 3
        }],
        "message": "success"
    },
    "id": "55428a70-a740-4b54-bd7f-89f727744740"
}

错误码

解绑用户和设备

定义描述

请求参数

返回参数

无业务返回值

示例

请求示例

• 传入openId和openIdAppKey

  {
     "id":1508232047194,
      "request": {
        "cloudToken": "109049c80bcde4c06b15f6f62e29a3ba",
        "apiVer": "1.0.4"
      },
      "params": {
        "openId":"10000000001",
        "openIdAppKey":"xxx"
      },
      "version": "1.0"
  }
  

• 传入identityId

  {
     "id":1508232047194,
      "request": {
        "cloudToken": "109049c80bcde4c06b15f6f62e29a3ba",
        "apiVer": "1.0.4"
      },
      "params": {
        "identityId": "506bop1ef3a1ce8005d731e0df57ae175ac94618"
      },
      "version": "1.0"
  }
  

  正常返回示例

  {
    "code": 200,
    "data": "",
    "id": "3389580f-c698-4a83-9eee-b576c6d6c874"
  }
  

错误码

根据身份id获取第三方openid

⚠️ 当且仅当使用第三方账号体系时有用

定义描述

请求参数

返回参数

示例

请求示例

{
     "id":1508232047194,
      "request": {
        "apiVer": "1.0.6"
      },
      "params": {
        "request": {
          "identityId":"506bop1ef3a1ce8005d731e0df57ae175ac94618",
          "openIdAppKey":"12345678"
        }
      },
      "version": "1.0"
}

正常返回示例

{
    "code": 200,
    "data": "506bop1ef3a1ce8005d731e0df57ae175ac94618",
    "id":"bb179e80-39fd-4a79-ba97-48ca87a3f5c5"
}

根据设备查找所有绑定的用户

请求参数

返回参数

示例

请求示例

{
     "id":1508232047194,
      "request": {
        "cloudToken": "109049c80bcde4c06b15f6f62e29a3ba",
        "apiVer": "1.0.4"
      },
      "params": {
        "iotId":"VPuHLddp6fisYryXdk0T0010dbd910",
        "pageNo": 1,
        "pageSize": 50
      },
      "version": "1.0"
}

正常返回示例

{
    "code": 200,
    "data": [
        {
            "identityId":506bop1ef3a1ce8005d731e0df57ae175ac94618,
            "owned":0
        }
    ],
    "id":"bb179e80-39fd-4a79-ba97-48ca87a3f5c5"
}

通过identityid查询账户的详细信息

定义描述

请求参数

返回参数

示例

请求示例

{
     "id":1508232047194,
      "request": {
        "cloudToken": "109049c80bcde4c06b15f6f62e29a3ba",
        "apiVer": "1.0.4"
      },
      "params": {
        "identityId":"506bop1ef3a1ce8005d731e0df57ae175ac94618"
      },
      "version": "1.0"
}

正常返回示例

{
    "code": 200,
    "data": [
        {
            "gmtModified":1515590332000,
            "loginId":"4398050099996",
            "gmtCreate":1513181985000,
            "lastLoginTime":1515590332000,
            "phone":"15757245467",
            "identityId":"5091op618500614829ee12fae93ba653a5928119",
            "loginName":"15757245467",
            "tenantId":"45CFEA759A994F48A8305D59452B1437",
            "loginSource":"openAccount"
            "email":"test@aliyun.com",
            "nickName":"test"
        }
    ],
    "id":"bb179e80-39fd-4a79-ba97-48ca87a3f5c5"
}

错误码