开启会话前,先调用相关服务,使用accessToken进行单点登陆后查看会话。
接口描述
请求
GET http://apigate.hsifue.cn/api/front/loginByAccessToken
请求header参数
| 参数 | 参数类型 | 参数约束 | 是否必传 | 示例值 | 描述 |
|---|---|---|---|---|---|
| session-id | 字符串 | 服务端返回,可从以下api中获取: - 开始新会话 - 会话超时,重启会话 | 否 | C3D205E1B4C72BF451CDC326328786A5 | 索引用户信息的key |
请求param参数
| 参数 | 参数类型 | 参数约束 | 是否必传 | 示例值 | 描述 |
|---|---|---|---|---|---|
| accessToken | 字符串 | 客户端获取 | 是 | cn-63a09245-b3f7-40da-9cd0-81e75e1ab1e2 | 通过客户端获取的accessToken,后台进行认证,实现单点登陆 |
| robot | 字符串 | 服务端获取 | 是 | GCCP | 机器人标识: 每次刚打开或者是切换机器人时, 从 获取机器人列表 接口获取 |
| chatid | 字符串 | 服务端获取 | 是 | 74139073-4cfd-449b -9479-7e2fb4895d4d | 会话ID,同一会话ID可能包含多组问答, 从初始会话 开始新会话 api获取 |
请求成功返回的数据
请求成功返回的字段描述
| 返回字段 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| session-id | 字符串 | C3D205E1B4C72BF451CDC326328786A5 | 服务端索引用户信息的key |
| user | 对象 | 如下 | 包括用户的基本信息,用于前端展示 |
| oAuth2AccessToken | 对象 | 如下 | 包括accessToken的信息,用于单点登陆 |
请求成功正确返回的数据基本示例
{
"code": 200,
"message": "success",
"result": {
"session-id": "5DC2D89A622594886FC383A0CD853F53",
"user": {
"id": 6557192726348111872,
"fullname": "13699127552",
"username": null,
"email": null,
"mobile": "13699127552",
"userId": "6557192726348112377",
"gender": null,
"birthday": null,
"qq": null,
"company": null,
"avatarETag": "07fd96b27f83a70ffbe45b30c277c804",
"displayName": "13699127552",
"strId": "6557192726348112377",
"nickname": null,
"accountName": "13699127552",
"chatid": "7c7c37ef-c22a-4b58-98d8-6317117562f0",
"uid": "DF162FEC3A2DA4B17DBEEB02B4FA7ACC",
"authStatus": 1,
"chatStatus": null
},
"oAuth2AccessToken": {
"access_token": "cn-63a09245-b3f7-40da-9cd0-81e75e1ab1e2",
"token_type": "bearer",
"refresh_token": "cn-214beef5-e889-4db4-b6c9-e64ecbcd57e4",
"expires_in": 151139.0,
"scope": "document_enterprise_files_write document_project_files_write document_incoming_files_read document_project_files_read document_my_files_read paas-workspace document_incoming_files_write account_token_login document_my_files_write document_appdata_read paas-authorizing account_info_write document_enterprise_files_read document_appdata_write account_info_read"
}
}
}
请求失败返回的数据
请求失败返回的数据基本示例 查看其它状态码
{
"code": 400,
"message": "Required parameter 'robot' is not present"
}
{
"code": 500,
"message": "java.lang.IndexOutOfBoundsException"
}
{
"code": 402,
"message": "login error"
}