账号服务

更新时间：2018-03-15 20:34:06

通过认证code生成IoT会话

定义描述

path 版本 描述 是否需要登陆
/account/createSessionByAuthCode 1.0.4 通过认证code生成iot会话 否

请求参数

名称 子键 类型 必填 描述
request ​ JSON 是 JSON对象
​ authCode String 是 OA sessionId、token以及三方的authToken，统称为authCode
​ accountType String 是 账号类型，当前支持的值"OA_SESSION"或"OA_TOKEN"
appKey String 是 业务方账号的appKey
registerPlatform String 否 注册平台

返回参数

名称 类型 描述
identityId String 账号的身份ID
iotToken String iot会话token
refreshToken String 刷新token
iotTokenExpire Integer iotToken有效时长，单位：秒
refreshTokenExpire Integer 刷新token的有效时长，单位：秒

示例

请求示例

{
    "request": {
        "apiVer": "1.0.4"
    },
    "params": {
        "request": {
            "authCode": "sdfsdfsdf",
            "appKey": "iuerierert",
            "accountType": "OA_SESSION"
        }
    },
    "version": "1.0"
}

正常返回示例

{
    "code": 200,
    "data": {
        "identityId": "50f2op52a61e7de2f741cce66eaac900fd071323",
        "iotToken": "267f8002434befa742b302871dde18a8",
        "refreshToken": "4DF38E239EA0B9D5A6B04D5262D9C15F",
        "iotTokenExpire":72000,
        "refreshTokenExpire":720000
    },
    "id":"a2845614-7156-42ff-94f7-9bc8db03bfa1"
}

错误码

错误码 错误信息 详细描述
2407 auth identity exception 通过authCode获取账号信息失败
2459 session invalid authCode验证无效
2461 accountType invalid accountType无效（格式非法或空值）
2462 authCode invalid authCode空值

校验或刷新IoT会话

定义描述

path 版本 描述 是否需要登陆
/account/checkOrRefreshSession 1.0.4 校验iot会话或刷新会话 是

请求参数

名称 子键 类型 必填 描述
request ​ JSON 是 JSON对象
​ identityId String 是 账号的身份ID
​ refreshToken String 是 刷新token

返回参数

名称 类型 描述
identityId String 账号的身份ID
iotToken String iot会话token
refreshToken String 刷新token
iotTokenExpire Integer iotToken有效时长，单位：秒
refreshTokenExpire Integer 刷新会员游戏时长，单位：秒

示例

请求示例

{
    "request": {
        "apiVer": "1.0.x"
    },
    "params": {
        "request": {
            "refreshToken": "267f8002434befa742b302871dde18a8",
            "identityId": "50f2op52a61e7de2f741cce66eaac900fd071323"
        }
    },
    "version": "1.0"
}

正常返回示例

{
    "code": 200,
    "data": {
        "identityId": "50f2op52a61e7de2f741cce66eaac900fd071323",
        "iotToken": "267f8002434befa742b302871dde18a8",
        "refreshToken": "4DF38E239EA0B9D5A6B04D5262D9C15F",
        "iotTokenExpire":72000,
        "refreshTokenExpire":720000
    },
   "id":"a2845614-7156-42ff-94f7-9bc8db03bfa1"
}

错误码

错误码 错误信息 详细描述
2401 refresh token is invalid refreshToken无效，包括refreshToken非法、refreshToken合法但其背后的identityId与入参不匹配
2405 identity is not existed identityId不存在
2460 refreshToken expired refreshToken过期

失效IoT会话

定义描述

path 版本 描述 是否需要登陆
/iotx/account/invalidSession 1.0.4 让IoT会话失效 是

请求参数

名称 子键 类型 必填 描述
request ​ JSON 是 JSON对象
​ identityId String 是 账号的身份ID
​ iotToken String 是 IoT会话

返回参数

名称 类型 描述

示例

请求示例

{
     "id":1508232047194,
      "request": {
        "apiVer": "1.0.x"
      },
      "params": {
        "request": {"identityId":"50e5opda16ebf5558e000a660ac9632a038c2479","iotToken":"322AD610F580652C2BB9A7DE73F59F38"}
      },
      "version": "1.0"
}

正常返回示例

{
   {"code":200,"data":"","id":"a2845614-7156-42ff-94f7-9bc8db03bfa1"}
}

错误码

错误码 错误信息 详细描述

results matching ""

    No results matching ""