账号服务

更新时间:2018-06-08 12:04:24

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

查询统一身份列表

定义描述

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

请求参数

名称 子键 类型 必填 描述
request JSON JSON对象
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"
}

错误码

错误码 错误信息 来源 描述
200 success 系统 成功
400 request error. 系统 请求错误
401 request auth error. 系统 请求认证错误
403 request forbidden. 系统 请求被禁止
404 service not found. 系统 服务未找到
429 too many requests. 系统 太多请求
460 request parameter error. 系统 请求参数错误
500 service error. 系统 服务端错误
503 service not available. 系统 服务不可用

修改账号属性

定义描述

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

请求参数

名称 子键 类型 必填 描述
request JSON JSON对象
iotToken String iotToken
accountMetaV2 JSON JSON对象
子键 类型 必填 描述
loginName String 登录名
phone 手机号和邮箱至少一个必填 手机号
email String 手机号和邮箱至少一个必填 邮箱
nickName String 昵称
password String 密码
appKey String OA 的appKey
creater String 创建者
modifier String 修改者
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"}

错误码

错误码 错误信息 来源 描述
200 success 系统 成功
400 request error. 系统 请求错误
401 request auth error. 系统 请求认证错误
403 request forbidden. 系统 请求被禁止
404 service not found. 系统 服务未找到
429 too many requests. 系统 太多请求
460 request parameter error. 系统 请求参数错误
500 service error. 系统 服务端错误
503 service not available. 系统 服务不可用

results matching ""

    No results matching ""