Log In¶
使用帐号密码登录 EnOS 应用门户。
请求格式¶
POST https://{apigw-address}/app-portal-service/v2.2/login
请求参数(Body)¶
名称 |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|
account |
必需 |
String |
用户名。 |
password |
必需 |
String |
登录密码。 |
响应参数¶
名称 |
数据类型 |
描述 |
---|---|---|
data |
List<JSONObject> |
用户信息。详见 用户信息结构体 |
用户信息结构体 ¶
名称 |
数据类型 |
描述 |
---|---|---|
organizations |
List<JSONObject> |
用户所在的组织列表,包含组织名称和ID。详见 IdNamePair结构体 |
user |
List<JSONObject> |
用户信息,包含用户名称和ID。详见 IdNamePair结构体 |
accessToken |
String |
Access Token,以Bearer Token表示。 |
mfaType |
String |
当前用户的双因子认证类型。 |
IdNamePair 结构体¶
名称 |
数据类型 |
描述 |
---|---|---|
id |
String |
用户ID或组织ID。 |
name |
String |
用户名称或组织名称。 |
String |
用户邮箱。 |
错误码¶
代码 |
错误信息 |
描述 |
---|---|---|
31400 |
The user name or password is wrong |
用户账号密码不能为空或者填写错误 |
31429 |
密码或IP错误次数过多,请稍后重试 |
示例¶
请求示例¶
url: https://{apigw-address}/app-portal-service/v2.2/login
method: POST
requestBody:
{"account":"portal_demo","password":"Test1234"}
返回示例¶
{
"code": 0,
"data": {
"accessToken": "your_access_token",
"mfaType": "NONE",
"organizations": [
{
"id": "your_org_id_1",
"name": "your_org_name_1"
},
{
"id": "your_org_id_2",
"name": "your_org_name_2"
}
],
"user": {
"id": "your_user_id",
"name": "your_user_name",
"email": "your_email"
}
},
"message": "OK"
}