Choose Organization¶
用户在登录 EnOS 应用门户后,选择需要进入的组织。
操作权限¶
用户需要登录 EnOS 应用门户。
请求格式¶
POST https://{apigw-address}/app-portal-service/v2.2/session/set?channel
请求参数(Query)¶
| 名称 | 必需/可选 | 数据类型 | 描述 | 
|---|---|---|---|
| channel | 可选 | String | 用户登陆来源。 | 
请求参数(Header)¶
| 名称 | 必需/可选 | 数据类型 | 描述 | 
|---|---|---|---|
| Authorization | 必需 | String | Access Token,以Bearer Token表示,其形式为 Bearer {your token}。需要通过调用 Log In 或 Refresh Access Token 接口后获取。 | 
| channel | 可选 | String | 用户登陆来源。 | 
请求参数(Body)¶
| 名称 | 必需/可选 | 数据类型 | 描述 | 
|---|---|---|---|
| orgId | 必需 | String | 组织ID。调用 Log In 接口登录后,获取用户可进入的组织ID。 | 
响应参数¶
| 名称 | 数据类型 | 描述 | 
|---|---|---|
| data | List<JSONObject> | 登录用户信息。详见 登录用户信息结构体 | 
登录用户信息结构体 
| 名称 | 数据类型 | 描述 | 
|---|---|---|
| userId | String | 用户ID。 | 
| userName | String | 用户名称。 | 
| currentOrgId | String | 当前组织ID。 | 
| currentOrgName | String | 当前组织名称。 | 
| accessToken | String | 请求中的 Access Token。 | 
| refreshToken | String | 可用于刷新当前 Access Token 的 Refresh Token。 | 
| refreshTokenExpire | Long | Refresh Token 的过期时间。以UTC时间表示,格式见 UTC采用的ISO8601标准时间格式>> | 
错误码¶
| 代码 | 错误信息 | 描述 | 
|---|---|---|
| 31400 | orgId is required | 组织ID不能为空 | 
| 31401 | Please login first | 请先登录,获取正确的Access Token | 
| 31404 | Can not find this organization. | 未找到对应组织 | 
示例¶
请求示例¶
url: https://{apigw-address}/app-portal-service/v2.2/session/set?channel=web
method: POST
headers: {"Authorization":"Bearer your_token"}
requestBody:
{"orgId":"yourOrgId"}
返回示例¶
{
  "code": 0,
  "message": "OK",
  "data": {
    "userId": "your_user_id",
    "userName": "your_user_name",
    "currentOrgId": "your_org_id",
    "currentOrgName": "your_org_name",
    "accessToken": "your_access_token",
    "refreshToken": "your_refresh_token",
    "refreshTokenExpire": 1570018958000
  }
}