文档首页/ 云空间服务 KooDrive/ API参考/ API/ 会话管理/ 初始化创建会话 - createSession
更新时间：2025-10-22 GMT+08:00
查看PDF
分享

初始化创建会话 - createSession

功能介绍

初始化创建会话。

授权信息

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

URI

POST /koodrive/ose/v1/session/

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Traceid

否

String

消息日志跟踪标识（必须58位）

language

否

String

国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语
表2 请求Body参数

参数

是否必选

参数类型

描述

code

是

String

授权码

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

code

Integer

响应码

msg

String

响应信息

data

SessionUserDto object

业务接口范围所需的授权码
表4 SessionUserDto

参数

参数类型

描述

accessToken

String

业务接口范围所需的授权码

sessionId

String

会话id

userId

String

用户标识

userInfo

SessionUserInfo object

企业级用户信息
表5 SessionUserInfo

参数

参数类型

描述

role

String

角色

  • 0：管理员

  • 1：普通用户

  • 2：超级管理员

userName

String

用户名

innerUserId

String

用户内部id

userId

String

用户外部id

tenantId

String

租户code，这里即企业code

orgId

String

orgId

orgName

String

orgId名称

xHwSchema

String

租户所分配的数据库对象集

userCount

Integer

用户数量

deptId

String

部门id

请求示例

初始化会话请求。

  POST /koodrive/ose/v1/session

{
  "code" : "FrbMohdqi86v6sMZlFSSuG3E0_9RsDpL08BlYfNQPhvibLET266cQhDI_WczEXJOAoIoKGCdqN2shKX1yfqrVci8nSFdMlxljNFhoffVvH93uSzIoyFxK4P7yhY6fDXa",
  "domain" : "kdconsole-***-***.************.cn:8080"
}

响应示例

状态码：200

会话响应信息

   ​​​{
    "data": {
        "accessToken": "Bearer 6ebb6266dd5cdefa1d7126af2eb6173ce0a054d8ba4295be",
        "sessionId": "c17c8903e9382a0aa1b82e9d42cb82ba12760a18d6cf018d",
        "userId": "1008600000701011122",
        "userInfo": {
            "role": "2",
            "userName": "199******04",
            "innerUserId": "1574641576007768198",
            "userId": "1008600000701011122",
            "tenantId": "28389189a7744593a59940c0d0fcd451",
            "orgId": "9190086000001721760",
            "orgName": "lym09",
            "deptId": "1574641574824974465",
            "userCount": 40,
            "xhwSchema": "tenants1_liantiao"
        }
    },
    "code": 0,
    "msg": "成功"
}

状态码

状态码

描述

200

会话响应信息
父主题： 会话管理

相关文档