eTowerOne Developers
页面树结构
转至元数据结尾
转至元数据起始

接口名称

登录

接口地址

/api/aggregator/v1/login

请求方式

POST

请求头

参数

类型

必填

说明

Accept

String

是

请求接受类型，固定值：application/json, text/plain, /

Content-Type

String

是

请求内容类型，固定值：application/json;charset=UTF-8

Referer

String

是

来源地址

language

String

是

语言

语言取值：

值

说明

zh_CN

中文

en_US

英文

请求参数

参数

类型

必填

说明

sessionId

String

是

会话ID（从预登录接口获取）

agentTenantId

Number

是

租户ID（从预登录接口的租户列表 partyId 中选择）

请求示例

curl 'https://stage-integrator.etowertech.com/api/aggregator/v1/login' \
  -X 'POST' \
  -H 'Accept: application/json, text/plain, */*' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  -H 'language: en_US' \
  --data-raw '{"sessionId":"rySNcWeqtZonS5bFfqXSkw","agentTenantId":100}'

返回示例

{
  "success": true,
  "code": "0",
  "data": {
    "sessionId": "rySNcWeqtZonS5bFfqXSkw",
    "agentTenantId": 100,
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "userInfo": {
      "id": 12508,
      "username": "dongyangdeng@walltechsystem.cn",
      "chineseName": "邓东阳",
      "email": "dongyangdeng@walltechsystem.cn"
    }
  },
  "errors": []
}

返回字段说明

字段

类型

说明

success

Boolean

请求是否成功

code

String

响应状态码，"0"表示成功

data

Object

登录结果数据

errors

Array

错误信息列表

data 字段说明

字段

类型

说明

sessionId

String

会话ID（用于后续业务接口的身份验证）

agentTenantId

Number

选中的租户ID

token

String

登录令牌

userInfo

Object

用户信息对象

userInfo 字段说明

字段

类型

说明

id

Number

用户ID

username

String

用户名

chineseName

String

中文名称

email

String

邮箱

登录流程说明

  1. 登录流程分为两步：
  2. 1. 调用预登录接口 (/api/platform/v1/preLogin)，提交用户名和密码
  3. 2. 预登录接口返回用户信息和租户列表
  4. 3. 用户从租户列表中选择一个租户（使用 partyId 作为 agentTenantId）
  5. 4. 调用登录接口 (/api/aggregator/v1/login)，提交 sessionId 和 agentTenantId
  6. 5. 登录成功后，使用返回的 sessionId 或 token 进行后续业务操作
  • 无标签