文档首页/ 云空间服务 KooDrive/ API参考（运营商）/ API/ 登录与退出/ 登录 - Login
更新时间：2026-05-15 GMT+08:00
查看PDF
分享

登录 - Login

功能介绍

登录

授权信息

当前API调用无需身份策略权限。

URI

POST /koodrive/ose/v1/auth/login

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Traceid

否

String

参数解释：

业务跟踪id（必须58位）

约束限制：

不涉及

取值范围：

长度为58位

默认值：

不涉及

x-hw-agentName

是

String

参数解释：

agentName

约束限制：

不涉及

取值范围：

不涉及

默认值：

不涉及
表2 请求Body参数

参数

是否必选

参数类型

描述

account

是

String

账号名，手机号

authType

是

String

验证类型：1账密验证 2验证码验证

password

否

String

密码

captchaToken

否

String

验证码Token

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

code

String

错误码

msg

String

错误描述

data

data object

登录结构体
表4 data

参数

参数类型

描述

userInfo

UserInfo object

用户信息

sessionInfo

SessionInfo object

鉴权信息
表5 UserInfo

参数

参数类型

描述

userId

String

用户ID

firstname

String

名字

surname

String

姓氏

phone

String

手机号

email

String

邮箱
表6 SessionInfo

参数

参数类型

描述

accessToken

String

访问Token

expiresIn

Long

有效期

issuedAt

String

产生时间

refreshToken

String

刷新Token

请求示例

POST /koodrive/ose/v1/auth/login

{
  "account": "0027188460911",
  "authType": "1",
  "password": "123qweASD143",
}

响应示例

状态码：200

登录响应

{
  "data" : {
    "userInfo" : {
      "userId" : "1882575898755117312",
      "firstname" : "firstname",
      "surname" : "surname",
      "phone" : "0027188460911",
      "email" : ""
    },
    "sessionInfo" : {
      "accessToken" : "AT 3b911d723003f70a1265124148fdfe486c108b64bf8d0de3",
      "expiresIn" : 1800,
      "issuedAt" : "1772006999088",
      "refreshToken" : "0e0e72d3c7e9e4444df6bc3fb111eaee18eb7b2393a939cb"
    }
  },
  "code" : 0,
  "msg" : "成功"
}

状态码

状态码

描述

200

登录响应
父主题： 登录与退出