账号服务

更新时间:2018-10-19 11:29:34

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

查询统一身份列表

定义描述

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需启用身份的鉴权

请求参数

参数 类型 必填 描述
iotToken String 是 iotToken
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,"data":"","id":"a2845614-7156-42ff-94f7-9bc8db03bfa1"}

错误码

请参考公共错误码

results matching ""

    No results matching ""