账号服务

更新时间:2019-01-22 19:12:48

提供一组与用户账号体系相关的服务接口,通过本组服务接口可以实现用户账户信息的查询和设置。

查询统一身份列表

定义描述

path 版本 描述 是否需要用户身份的鉴权
/iotx/account/queryIdentityList 1.0.4 查询统一身份列表

请求参数

参数 类型 必填 描述
identityIds List 账号身份id列表

返回参数

名称 类型 必有 描述
identityId String 账号身份id
loginId String OA loginId
loginSource String 账号来源,目前为openAccount
loginName String 登录名
phone String 手机号
email String 邮箱
nickName String 昵称
avatarUrl String 头像链接
gmtCreate Long 创建时间
gmtModified Long 修改时间

示例

请求示例

{
     "id":1508232047194,
      "request": {
        "apiVer": "1.0.4"
      },
      "params": {
        "request": {"identityIds":["506bop1ef3a1ce8005d731e0df57ae175ac94618"]}
      },
      "version": "1.0"
}

正常返回示例

{
    "code": 200,
    "data": [
        {
            "gmtModified": 1508314232000,
            "loginId": "4398047084811",
            "gmtCreate": 1508314232000,
            "identityId": "506bop1ef3a1ce8005d731e0df57ae175ac94618",
            "loginSource": "openAccount",
        }
    ],
    "id":"bb179e80-39fd-4a79-ba97-48ca87a3f5c5"
}

错误码

请参考公共错误码

修改账号属性

定义描述

path 版本 描述 是否需要用户身份的鉴权
/iotx/account/modifyAccount 1.0.4 修改账号属性 是,客户端SDK需启用身份的鉴权

请求参数

参数 类型 必填 描述
identityId String identityId
accountMetaV2 JSON 账户属性信息

accountMetaV2结构

参数 类型 必填 描述
loginName ​String ​登录名
phone ​String 手机号和邮箱至少一个必填 ​手机号
email ​String 手机号和邮箱至少一个必填 ​邮箱
nickName String 昵称
appKey String OA 的appKey
avatarUrl String 头像链接

返回参数

名称 类型 必有 描述

示例

请求示例

{
     "id":1508232047194,
      "request": {
        "iotToken": "109049c80bcde4c06b15f6f62e29a3ba",
        "apiVer": "1.0.4"
      },
      "params": {
        "request": {"identityId":"50e5opda16ebf5558e000a660ac9632a038c2479", "accountMetaV2":{"phone":"15757286621", "appKey":"60039075","nickName":"test"}}
      },
      "version": "1.0"
}

正常返回示例

{
  "code": 200,
  "message": "success",
  "localizedMsg": null,
  "class": "com.aliyun.iotx.common.base.service.IoTxResult"
}

错误码

请参考公共错误码

results matching ""

    No results matching ""