在线系统获取会话数据
查询会话导出文件
使用 /openapi/export/session 或 /openapi/export/session/v1 返回的 key 查询会话导出文件地址。
- 请求体格式为
{"key":"创建任务接口返回的值"};key 可为 8 位 token 或数字下载任务 ID。 - 本接口不受凌晨导出时间窗口限制,但仍校验签名、IP 白名单和企业白名单。
- 文件未生成时返回 14520,message 为
Wait...,请稍后重试;生成完成后返回 200,message 为文件下载 URL。 - 8 位 token 对应的旧下载链路返回加密 ZIP,下载链接有效期为 6 小时,解压密码为当前企业 appKey 的前 12 个字符,压缩包内包含 session.txt 和 message.txt。若 key 为数字下载任务 ID,文件格式及密码规则以企业当前下载任务配置和实际返回文件为准。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| time | any | 是 | 请求时间戳(秒);用于签名鉴权 | |
| checksum | any | 是 | 请求签名校验和 | |
| checksumAlgorithm | integer | 否 | 签名算法:0 - 默认(SHA1),1 - SHA256;不传默认为 0 | |
| appKey | string | 是 | 应用 AppKey |
请求体
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| key | string | 是 | 创建导出任务接口返回的 token 或下载任务 ID | AbCdEfGh |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| code | int32 | 状态码,200 表示成功 | 200 |
| message | string | 成功时为导出 token、下载任务 ID 或文件下载 URL;失败时为错误原因 | AbCdEfGh |
错误码
| 状态码 | 描述 |
|---|---|
| 14001 | AppKey 不存在 |
| 14002 | checksum 校验失败 |
| 14003 | 请求时间戳与服务器时间误差超过 10 分钟 |
| 14004 | 请求体为空、key 缺失或下载任务不存在 |
| 14008 | IP 或企业不在导出白名单内 |
| 14500 | 服务内部异常 |
| 14520 | 导出文件尚未生成,message 为 Wait... |
postEndpoint
/openapi/export/session/checkcurl -X POST "https://qiyukf.com/openapi/export/session/check?time=1739347200&checksum=a1b2c3d4e5f607182930abcdefabcdef&checksumAlgorithm=0&appKey=9f1d7c2b8a6e4d3c" \ -H "Content-Type: application/json" \ -d '{ "key": "AbCdEfGh" }'{
"code": 200,
"message": "AbCdEfGh"
}{
"code": 14001,
"message": "AppKey 不存在"
}{
"code": 14002,
"message": "checksum 校验失败"
}{
"code": 14003,
"message": "请求时间戳与服务器时间误差超过 10 分钟"
}{
"code": 14004,
"message": "请求体为空、key 缺失或下载任务不存在"
}{
"code": 14008,
"message": "IP 或企业不在导出白名单内"
}{
"code": 14500,
"message": "服务内部异常"
}{
"code": 14520,
"message": "导出文件尚未生成,message 为 Wait..."
}这篇文档有帮助吗?