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
}
}