在线系统获取会话数据
创建专用会话导出任务
专用会话导出入口。请求体只传 endTime,开始时间默认向前半小时计算,且默认 15 分钟内只能调用一次。该接口只校验企业白名单,不校验 checksum。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| time | any | 是 | 请求时间戳(秒) | |
| checksum | any | 是 | 请求签名校验和 | |
| checksumAlgorithm | integer | 否 | 签名算法:0 - 默认(SHA1),1 - SHA256;不传默认为 0 | |
| appKey | string | 是 | 应用 AppKey |
请求体
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| endTime | int64 | 是 | 导出结束时间,毫秒时间戳。开始时间默认按 endTime 向前半小时计算。 | 1735747199999 |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| code | int32 | 状态码,200 表示成功 | 200 |
| message | string | 成功时为导出 token、下载任务 ID 或文件下载 URL;失败时为错误原因 | AbCdEfGh |
错误码
| 状态码 | 描述 |
|---|---|
| 14001 | AppKey 不存在,或企业不在 v1 白名单内 |
| 14002 | checksum 校验失败 |
| 14003 | 请求时间戳与服务器时间误差超过 10 分钟 |
| 14004 | 请求体为空、endTime 缺失、时间戳非法或调用间隔过短 |
| 14009 | 当前企业运行中的导出任务过多,或旧链路导出锁未释放 |
| 14500 | 服务内部异常或创建下载任务失败 |
postEndpoint
/openapi/export/v1/sessioncurl -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": "服务内部异常或创建下载任务失败"
}这篇文档有帮助吗?
查询专用会话导出文件
使用 /v1/session 返回的 token/下载任务 ID 查询专用会话导出文件地址。按企业当前下载方式,key 可表示 token 或下载任务 ID;任务完成后返回 URL,未完成返回等待状态。该接口只校验企业白名单,不校验 15 分钟调用间隔。
批量上传订单信息
批量上传企业订单信息,请求体为使用应用密钥 AES 加密后的订单 JSON 数组。解密后每条订单需包含 orderId(1-255 字符)、uid(1-128 字符)、payTime(>0),可选字段:status(0-4)、orderTime、amount、price、refundNo、refundTime。单次最多上传 1000 条。