基本信息
接口名称:
随机本地视频
请求方法:
GET
计费类型:
免费
接口文档
# API文档:随机本地视频
## 接口说明
随机返回服务器本地存储的视频资源访问信息,支持按分类筛选。
## 请求地址
`/api/random-local-video`
## 请求方法
GET
## 请求参数
| 参数名 | 类型 | 必填 | 说明 |
|----------|--------|------|--------------------------|
| category | string | 否 | 视频分类目录(对应服务器本地`videos/[category]`目录) |
## 返回参数
| 参数名 | 类型 | 说明 |
|----------|--------|--------------------------|
| code | string | 状态码(200=成功)|
| msg | string | 状态描述 |
| data | object | 视频信息 |
| ├ video_url | string | 视频访问地址(服务器静态路径) |
| ├ title | string | 视频标题 |
| ├ duration | string | 视频时长 |
| ├ filename | string | 视频文件名 |
## 示例响应
```json
{
"code": "200",
"msg": "请求成功",
"data": {
"video_url": "/static/videos/nature/spring.mp4",
"title": "春日风景",
"duration": "03:25",
"filename": "spring.mp4"
}
}
请求参数
| 参数名 | 是否必填 | 类型 | 参数说明 | 示例值 |
|---|---|---|---|---|
| category | 否 | string | 视频分类目录 |
请求示例
{
"category": ""
}
返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | string | 接口状态码 |
| msg | string | 接口状态描述 |
| data | string | 视频资源信息容器 |
| video_url | string | 视频访问地址(服务器静态路径 |
| title | string | 视频标题 |
| duration | string | 视频时长 |
| filename | string | 视频文件名 |
返回示例
{
"code": "200",
"msg": "\"请求成功\"",
"data": "-",
"video_url": "\"\/static\/videos\/spring.mp4\"",
"title": "\"春日风景\"",
"duration": "\"03:25\"",
"filename": "\"spring.mp4\""
}