七鱼开发文档中心
总览服务端 APIWebiOSAndroid鸿蒙Uniapp微信小程序插件三方接入
在线系统获取会话数据

创建专用会话导出任务

专用会话导出入口。请求体只传 endTime,开始时间默认向前半小时计算,且默认 15 分钟内只能调用一次。该接口只校验企业白名单,不校验 checksum。

请求参数

名称类型必填描述示例值
timeany是请求时间戳(秒)
checksumany是请求签名校验和
checksumAlgorithminteger否签名算法:0 - 默认(SHA1),1 - SHA256;不传默认为 0
appKeystring是应用 AppKey

请求体

名称类型必填描述示例值
endTimeint64是导出结束时间,毫秒时间戳。开始时间默认按 endTime 向前半小时计算。1735747199999

返回参数

名称类型描述示例值
codeint32状态码,200 表示成功200
messagestring成功时为导出 token、下载任务 ID 或文件下载 URL;失败时为错误原因AbCdEfGh

错误码

状态码描述
14001AppKey 不存在,或企业不在 v1 白名单内
14002checksum 校验失败
14003请求时间戳与服务器时间误差超过 10 分钟
14004请求体为空、endTime 缺失、时间戳非法或调用间隔过短
14009当前企业运行中的导出任务过多,或旧链路导出锁未释放
14500服务内部异常或创建下载任务失败
postEndpoint
/openapi/export/v1/session
POST
/openapi/export/v1/session
curl -X POST "https://qiyukf.com/openapi/export/v1/session?time=1739347200&checksum=a1b2c3d4e5f607182930abcdefabcdef&checksumAlgorithm=0&appKey=9f1d7c2b8a6e4d3c" \  -H "Content-Type: application/json" \  -d '{    "endTime": 1735747199999  }'
{
  "code": 200,
  "message": "AbCdEfGh"
}
{
  "code": 14001,
  "message": "AppKey 不存在,或企业不在 v1 白名单内"
}
{
  "code": 14002,
  "message": "checksum 校验失败"
}
{
  "code": 14003,
  "message": "请求时间戳与服务器时间误差超过 10 分钟"
}
{
  "code": 14004,
  "message": "请求体为空、endTime 缺失、时间戳非法或调用间隔过短"
}
{
  "code": 14009,
  "message": "当前企业运行中的导出任务过多,或旧链路导出锁未释放"
}
{
  "code": 14500,
  "message": "服务内部异常或创建下载任务失败"
}

这篇文档有帮助吗?