跳到主要内容

查询驱动音频列表

1.接口说明​

请求该接口查询驱动音频列表，支持分页查询。

  • 按创建时间倒序排列。
  • 仅返回上传成功且有效的音频。

2.请求地址​

https://digitbot.bokecc.com/api/scene/audio/page

3.请求方式​

GET

4.请求参数​

(1).公共参数，参考服务说明。​

(2).接口参数​

①.Query参数：通过URL参数传递。​

参数名类型必需说明
versionString是接口版本号，当前支持版本：1.0.0。
filenameString否音频文件名，模糊匹配查询，默认查询全部。
startDateString否开始日期，包含，格式：yyyy-MM-dd。
endDateString否结束日期，包含，格式：yyyy-MM-dd。
pageNumInteger否查询页码，正整数。默认值：1。
pageSizeInteger否分页大小，正整数，取值范围为[1, 100]区间，默认值：25。
  • startDate、endDate：两个参数同时传值且符合规范时，条件生效，过滤驱动音频创建时间。
    • startDate和endDate间隔不超过1年。
  • 查询参数条件为 并且 的关系。

5.请求示例​

GET https://digitbot.bokecc.com/api/scene/audio/page?pageNum=1&pageSize=50&accountId=xxx&version=1.0.0&hash=xxx&time=xxx HTTP/1.1

6.响应示例​

{
    "count": 100,
	"items": [{
        "id": "xxx",
		"filename": "xxxxx",
		"size": 12345,
		"createTime": "2024-01-29 12:25:00",
		"finishTime": "",
		"audioUrl": "https://ssssxxx.xxx.xxx",
		"duration": 123456
    }, ...]
}

7.响应说明​

字段名类型说明
countLong符合查询条件的驱动音频总数量。
itemsArray查询页返回的驱动音频(audio)列表。

audio字段说明​

字段名类型说明
idString驱动音频ID。
filenameString驱动音频文件名。
sizeLong驱动音频文件大小，单位：B(字节)。
createTimeString创建时间，yyyy-MM-dd HH:mm:ss格式。
finishTimeString完成时间，yyyy-MM-dd HH:mm:ss格式。
audioUrlString驱动音频地址。
durationLong音频时长，单位：毫秒。